{"openapi":"3.1.1","info":{"title":"Core","description":"Core services for Scalar","version":"0.1.0","contact":{"name":"Marc from Scalar","url":"https://scalar.com","email":"support@scalar.com"}},"servers":[{"url":"https://api.scalar.com/core"}],"tags":[{"name":"webhooks","description":"Register endpoints for platform events, and inspect what was delivered to them."}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"400":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"401":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"403":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"404":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"422":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"500":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"]},"nanoid":{"type":"string","minLength":5},"timestamp":{"type":"integer","minimum":0,"maximum":9007199254740991},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"team-ref":{"type":"object","properties":{"teamUid":{"type":"string"},"teamName":{"$ref":"#/components/schemas/team-name"},"teamImageUri":{"$ref":"#/components/schemas/team-image"}},"required":["teamUid","teamName"],"additionalProperties":false},"team-name":{"type":"string"},"team-image":{"type":"string"},"user":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"theme":{"type":"string"},"userIndex":{"type":"string"},"email":{"$ref":"#/components/schemas/email"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/team-ref"}},"activeTeamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasGithub":{"default":false,"type":"boolean"},"hasBitbucket":{"default":false,"type":"boolean"},"forgejoToken":{"type":"string"}},"required":["uid","createdAt","updatedAt","userIndex","email","teams","activeTeamId","hasGithub","hasBitbucket"],"additionalProperties":false},"token-response":{"type":"object","properties":{"refreshToken":{"type":"string"},"accessToken":{"type":"string"}},"required":["refreshToken","accessToken"],"additionalProperties":false},"slug":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z](?:[a-z0-9-]*[a-z0-9])?$"},"identity-provider-record":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"name":{"type":"string"},"provider":{"type":"string","enum":["local","google","okta","auth0","azure","one-login","ping-identity"]},"createUsers":{"default":false,"type":"boolean"},"signRequests":{"default":false,"type":"boolean"},"ssoUrl":{"default":"","description":"This URL is used by Scalar to initiate a SAML login.","type":"string"},"issuer":{"default":"","description":"This is the URI that identifies your SAML identity provider. Any assertions must use a matching attribute.","type":"string"},"x509Cert":{"default":"","description":"The authentication certificate issued by your identity provider","type":"string"},"consumerOnly":{"type":"boolean"}},"required":["uid","createdAt","updatedAt","name","provider","createUsers","signRequests","ssoUrl","issuer","x509Cert","consumerOnly"],"additionalProperties":false},"sso-resource":{"type":"string","enum":["apis","schemas","rules","sdks","workspaces","sync-project","project","publish","mcp","namespace"]},"active-deployment":{"type":"object","properties":{"uid":{"type":"string"},"domain":{"type":"string"},"publishedAt":{"$ref":"#/components/schemas/timestamp"}},"required":["uid","domain","publishedAt"],"additionalProperties":false},"project-version":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"name":{"default":"Default Version","type":"string"},"primaryGuideId":{"type":"string"},"primaryReferenceId":{"type":"string"},"references":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/reference"}},"guides":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/guide"}},"header":{"type":"array","items":{"$ref":"#/components/schemas/header-link"}},"footer":{"default":"","type":"string"},"footerCss":{"default":"","type":"string"},"footerBelowSidebar":{"default":false,"type":"boolean"},"headScript":{"default":"","type":"string"},"bodyScript":{"default":"","type":"string"}},"required":["uid","name","primaryGuideId","primaryReferenceId","references","guides","header","footer","footerCss","footerBelowSidebar","headScript","bodyScript"],"additionalProperties":false},"reference":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"description":{"type":"string"},"yjsReference":{"$ref":"#/components/schemas/nanoid"},"config":{"default":"{}","type":"string"},"specPermalink":{"default":"","type":"string"},"managedDoc":{"default":null,"anyOf":[{"$ref":"#/components/schemas/reference-managed-doc"},{"type":"null"}]},"show":{"default":true,"type":"boolean"},"isButton":{"default":false,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"}},"required":["uid","title","description","yjsReference","config","specPermalink","managedDoc","show","isButton","isStarred"],"additionalProperties":false},"reference-managed-doc":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"},"versions":{"default":["latest"],"type":"array","items":{"type":"string"}}},"required":["namespace","slug","versions"],"additionalProperties":false},"namespace":{"type":"string","minLength":3,"maxLength":50,"pattern":"^[a-zA-Z0-9-_]+$"},"guide":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"description":{"type":"string"},"sidebar":{"$ref":"#/components/schemas/sidebar"},"show":{"default":true,"type":"boolean"},"isButton":{"default":false,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"}},"required":["uid","title","description","sidebar","show","isButton","isStarred"],"additionalProperties":false},"sidebar":{"type":"object","properties":{"items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/sidebar-item"}},"children":{"type":"array","items":{"type":"string"}}},"required":["items","children"],"additionalProperties":false},"sidebar-item":{"anyOf":[{"$ref":"#/components/schemas/sidebar-link"},{"$ref":"#/components/schemas/sidebar-page"},{"$ref":"#/components/schemas/sidebar-folder"}]},"sidebar-link":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string","minLength":1},"type":{"type":"string","const":"Link"},"link":{"type":"string"},"icon":{"$ref":"#/components/schemas/project-icon"},"children":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"show":{"type":"boolean"}},"required":["uid","title","type","link","show"],"additionalProperties":false},"project-icon":{"$ref":"#/components/schemas/project-icon-info"},"project-icon-info":{"type":"object","properties":{"src":{"default":"","type":"string"},"title":{"type":"string"},"mask":{"type":"boolean"}},"required":["src"],"additionalProperties":false},"sidebar-page":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string","minLength":1},"type":{"type":"string","const":"Page"},"link":{"type":"string"},"icon":{"$ref":"#/components/schemas/project-icon"},"children":{"default":[],"type":"array","items":{"type":"string"}},"description":{"type":"string"},"show":{"type":"boolean"},"sidebarTitle":{"type":"string"},"defaultOpen":{"type":"boolean"},"yjsReference":{"type":"string"},"backgroundImage":{"type":"string"},"isMdx":{"default":false,"type":"boolean"},"isHtml":{"default":false,"type":"boolean"}},"required":["uid","title","type","children","description","show","yjsReference","isMdx","isHtml"],"additionalProperties":false},"sidebar-folder":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string","minLength":1},"type":{"type":"string","const":"Folder"},"link":{"type":"string"},"icon":{"$ref":"#/components/schemas/project-icon"},"children":{"default":[],"type":"array","items":{"type":"string"}},"description":{"type":"string"},"show":{"type":"boolean"},"defaultOpen":{"type":"boolean"}},"required":["uid","title","type","children","show"],"additionalProperties":false},"header-link":{"anyOf":[{"$ref":"#/components/schemas/header-link-guide"},{"$ref":"#/components/schemas/header-link-reference"},{"$ref":"#/components/schemas/header-link-group"},{"$ref":"#/components/schemas/header-link-external"},{"$ref":"#/components/schemas/header-link-version-selector"},{"$ref":"#/components/schemas/header-link-spacer"}]},"header-link-guide":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"guide"}},"required":["uid","title","show","isStarred","type"],"additionalProperties":false},"header-link-reference":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"reference"},"hasPermalink":{"default":false,"description":"Whether the reference has a permalinked reference or not","type":"boolean"},"hasManagedDoc":{"default":false,"description":"Whether the reference has a linked registry API","type":"boolean"}},"required":["uid","title","show","isStarred","type","hasPermalink","hasManagedDoc"],"additionalProperties":false},"header-link-group":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"group"},"children":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/header-link-guide"},{"$ref":"#/components/schemas/header-link-reference"},{"$ref":"#/components/schemas/header-link-external"}]},"description":"Children of the group. Groups cannot contain other groups, spacers, or the version selector"}},"required":["uid","title","show","isStarred","type","children"],"additionalProperties":false},"header-link-external":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"link"},"isButton":{"default":false,"type":"boolean"},"link":{"type":"string"}},"required":["uid","title","show","isStarred","type","isButton","link"],"additionalProperties":false},"header-link-version-selector":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"version-selector"}},"required":["uid","title","show","isStarred","type"],"additionalProperties":false},"header-link-spacer":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string"},"show":{"default":true,"type":"boolean"},"isStarred":{"default":false,"type":"boolean"},"type":{"type":"string","const":"spacer"}},"required":["uid","title","show","isStarred","type"],"additionalProperties":false},"logo":{"type":"object","properties":{"darkMode":{"type":"string"},"lightMode":{"type":"string"}},"required":["darkMode","lightMode"],"additionalProperties":false},"website":{"type":"object","properties":{"lastDeployed":{"$ref":"#/components/schemas/timestamp"},"subdomainPrefix":{"type":"string"},"customUrl":{"type":"string"},"subPath":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"favicon":{"type":"string"},"ogImage":{"type":"string"},"proxy":{"type":"string","format":"uri"},"routing":{"default":{"guidePathPattern":"","referencePathPattern":""},"type":"object","properties":{"guidePathPattern":{"type":"string"},"referencePathPattern":{"type":"string"}},"additionalProperties":false},"redirects":{"default":[],"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}}},"required":["lastDeployed","subdomainPrefix","customUrl","routing","redirects"],"additionalProperties":false},"project":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"name":{"type":"string"},"activeDeployment":{"default":null,"anyOf":[{"$ref":"#/components/schemas/active-deployment"},{"type":"null"}]},"lastPublished":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]},"lastPublishedUid":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"loginPortalUid":{"default":"","type":"string"},"activeThemeId":{"default":"","type":"string"},"typesenseId":{"type":"number"},"isPrivate":{"default":false,"type":"boolean"},"agentEnabled":{"default":false,"type":"boolean"},"analyticsEnabled":{"default":true,"type":"boolean"},"accessGroups":{"default":[]},"versions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/project-version"}},"activeTemplateId":{"default":"","type":"string"},"activeVersionId":{"default":"","type":"string"},"logo":{"$ref":"#/components/schemas/logo"},"website":{"description":"Deployed site configuration for a project","$ref":"#/components/schemas/website"},"insertPageTitles":{"default":true,"type":"boolean"}},"required":["uid","createdAt","updatedAt","name","activeDeployment","lastPublished","lastPublishedUid","loginPortalUid","activeThemeId","isPrivate","agentEnabled","analyticsEnabled","accessGroups","versions","activeTemplateId","activeVersionId","logo","website","insertPageTitles"],"additionalProperties":false},"team-list-mine-entry":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"name":{"$ref":"#/components/schemas/team-name"},"slug":{"$ref":"#/components/schemas/slug"},"imageUri":{"$ref":"#/components/schemas/team-image"},"theme":{"type":"string"}},"required":["uid","name","slug","theme"],"additionalProperties":false},"role":{"type":"string","enum":["owner","admin","editor","viewer"]},"billing-invoice":{"type":"object","properties":{"id":{"type":"string"},"total":{"type":"number"},"status":{"anyOf":[{"$ref":"#/components/schemas/invoice-status"},{"type":"null"}]},"paymentDate":{"type":"number"},"currency":{"type":"string"},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","total","status","paymentDate","currency"],"additionalProperties":false},"invoice-status":{"type":"string","enum":["open","paid","draft","void","uncollectible"]},"card":{"type":"object","properties":{"last4":{"type":"string","minLength":4,"maxLength":4},"expMonth":{"type":"number"},"expYear":{"type":"number"}},"required":["last4","expMonth","expYear"],"additionalProperties":false},"billing-info":{"type":"object","properties":{"billingId":{"$ref":"#/components/schemas/nanoid"},"email":{"$ref":"#/components/schemas/email"},"plan":{"$ref":"#/components/schemas/billing-plan"},"expires":{"type":"number"},"sdkTrialReminderSentAt":{"type":"number"},"trialEndedReminderSentAt":{"type":"number"},"trialExtendedAt":{"type":"number"},"includedCreditsOverride":{"type":"number"},"pastDue":{"type":"boolean"}},"required":["email","plan"],"additionalProperties":false},"billing-plan":{"type":"string","enum":["trial","free","pro_monthly","pro_yearly","premium","enterprise"]},"team-billing-summary":{"type":"object","properties":{"invoices":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/billing-invoice"}},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"card":{"anyOf":[{"$ref":"#/components/schemas/card"},{"type":"null"}]},"billingInfo":{"$ref":"#/components/schemas/billing-info"}},"required":["invoices","address","card","billingInfo"],"additionalProperties":false},"custom-project-icon":{"type":"object","properties":{"src":{"default":"","type":"string"},"title":{"type":"string"},"mask":{"type":"boolean"},"tags":{"default":[],"type":"array","items":{"type":"string"}},"group":{"type":"string","const":"custom"},"createdAt":{"$ref":"#/components/schemas/timestamp"},"uploadedBy":{"type":"string"}},"required":["src","tags","group","createdAt","uploadedBy"],"additionalProperties":false},"theme":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"name":{"type":"string"},"description":{"type":"string"},"theme":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["uid","name","description","theme","slug"],"additionalProperties":false},"object":{"type":"object","propertyNames":{"anyOf":[{"type":"string"},{"type":"number"},{}]},"additionalProperties":{}},"github-install":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"icon":{"type":"string"},"repos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["id","name","repos"],"additionalProperties":false},"github-project-repository":{"type":"object","properties":{"linkedBy":{"type":"string"},"id":{"type":"number"},"name":{"type":"string","minLength":2},"configPath":{"default":"","type":"string"},"branch":{"default":"","type":"string"},"publishOnMerge":{"default":false,"type":"boolean"},"publishPreviews":{"default":false,"type":"boolean"},"prComments":{"default":false,"type":"boolean"},"expired":{"default":false,"type":"boolean"}},"required":["linkedBy","id","name","configPath","branch","publishOnMerge","publishPreviews","prComments","expired"],"additionalProperties":false},"github-project":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"name":{"type":"string"},"activeDeployment":{"default":null,"anyOf":[{"$ref":"#/components/schemas/active-deployment"},{"type":"null"}]},"lastPublished":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]},"lastPublishedUid":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"loginPortalUid":{"default":"","type":"string"},"activeThemeId":{"default":"","type":"string"},"typesenseId":{"type":"number"},"isPrivate":{"default":false,"type":"boolean"},"agentEnabled":{"default":false,"type":"boolean"},"analyticsEnabled":{"default":true,"type":"boolean"},"accessGroups":{"default":[]},"slug":{"$ref":"#/components/schemas/slug"},"publishStatus":{"default":"","type":"string"},"publishMessage":{"default":"","type":"string"},"repository":{"anyOf":[{"$ref":"#/components/schemas/github-project-repository"},{"type":"null"}]}},"required":["uid","createdAt","updatedAt","name","activeDeployment","lastPublished","lastPublishedUid","loginPortalUid","activeThemeId","isPrivate","agentEnabled","analyticsEnabled","accessGroups","slug","publishStatus","publishMessage"],"additionalProperties":false},"doc-instance":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"version":{"$ref":"#/components/schemas/version"},"jsonSha":{"type":"string","pattern":"^[a-f0-9]{64}$"},"yamlSha":{"type":"string","pattern":"^[a-f0-9]{64}$"},"uploadedBy":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"$ref":"#/components/schemas/doc-instance-source"},"origin":{"default":{"type":"platform"},"$ref":"#/components/schemas/doc-instance-origin"},"message":{"default":"","type":"string"},"parentInstanceUid":{"default":null,"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"mergeParentUid":{"default":null,"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"revertOf":{"default":null,"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"servable":{"default":true,"type":"boolean"}},"required":["uid","createdAt","updatedAt","version","jsonSha","yamlSha","uploadedBy","source","origin","message","parentInstanceUid","mergeParentUid","revertOf","servable"],"additionalProperties":false},"version":{"type":"string","minLength":1},"doc-instance-source":{"type":"string","enum":["manual","cli","api","git-sync","url-sync","migration"]},"doc-instance-origin":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"platform"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"git"},"commitSha":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"branch":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"draft":{"default":null,"anyOf":[{"type":"object","properties":{"prNumber":{"type":"number"},"branch":{"type":"string"},"resolution":{"default":null,"anyOf":[{"type":"string","enum":["merged","closed"]},{"type":"null"}]}},"required":["prNumber","branch","resolution"],"additionalProperties":false},{"type":"null"}]}},"required":["type","commitSha","branch","draft"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"url"},"url":{"type":"string","format":"uri"}},"required":["type","url"],"additionalProperties":false}]},"method":{"type":"string","enum":["delete","get","head","options","patch","post","put","trace"]},"managed-doc-version":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"createdAt":{"type":"number"},"version":{"$ref":"#/components/schemas/version"},"upgraded":{"default":false,"type":"boolean"},"embedStatus":{"default":null,"anyOf":[{"type":"string","enum":["complete","failed"]},{"type":"null"}]},"tags":{"default":[],"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"method":{"$ref":"#/components/schemas/method"},"enabledTools":{"type":"array","items":{"type":"string","enum":["execute-request","get-mini-openapi-spec"]}}},"required":["path","method","enabledTools"],"additionalProperties":false}},"yamlSha":{"type":"string"},"jsonSha":{"type":"string"}},"required":["uid","createdAt","version","upgraded","embedStatus","tags"],"additionalProperties":false},"access-group-name":{"type":"string","maxLength":40},"access-group":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"name":{"default":"","$ref":"#/components/schemas/access-group-name"},"slug":{"default":"randomAccessGroupSlug()","$ref":"#/components/schemas/slug"},"allowedEmails":{"default":[]},"allowedDomains":{"default":[]}},"required":["uid","createdAt","updatedAt","name","slug","allowedEmails","allowedDomains"],"additionalProperties":false},"email-domain":{"type":"string","maxLength":253,"pattern":"^([A-Za-z0-9]+(-[A-Za-z0-9]+)*\\.)+[A-Za-z]{2,}$"},"login-portal-email":{"type":"object","properties":{"logo":{"default":"","type":"string"},"logoSize":{"default":"100","type":"string"},"buttonText":{"default":"Login","type":"string","maxLength":50},"message":{"default":"Click to access private documentation hosted by scalar.com","type":"string","maxLength":1000},"title":{"default":"Private Docs","type":"string","maxLength":100},"mainColor":{"default":"#2a2f45","type":"string","maxLength":100},"mainBackground":{"default":"#f6f6f6","type":"string","maxLength":100},"cardColor":{"default":"#2a2f45","type":"string","maxLength":100},"cardBackground":{"default":"#fff","type":"string","maxLength":100},"buttonColor":{"default":"#fff","type":"string","maxLength":100},"buttonBackground":{"default":"#0f0f0f","type":"string","maxLength":100}},"required":["logo","logoSize","buttonText","message","title","mainColor","mainBackground","cardColor","cardBackground","buttonColor","buttonBackground"],"additionalProperties":false},"login-portal-page":{"type":"object","properties":{"title":{"default":"Scalar Private Docs","type":"string","maxLength":100},"description":{"default":"Login to access your documentation","type":"string","maxLength":500},"head":{"default":"","type":"string"},"script":{"default":"","type":"string"},"theme":{"default":"","type":"string"},"companyName":{"default":"","type":"string","maxLength":100},"logo":{"default":"","type":"string"},"logoURL":{"default":"","type":"string"},"favicon":{"default":"","type":"string"},"termsLink":{"default":"","type":"string"},"privacyLink":{"default":"","type":"string"},"formTitle":{"default":"Scalar Private Docs","type":"string","maxLength":100},"formDescription":{"default":"Login to access your documentation","type":"string","maxLength":500},"formImage":{"default":"","type":"string"}},"required":["title","description","head","script","theme","companyName","logo","logoURL","favicon","termsLink","privacyLink","formTitle","formDescription","formImage"],"additionalProperties":false},"login-portal":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string","maxLength":200},"slug":{"$ref":"#/components/schemas/slug"},"email":{"$ref":"#/components/schemas/login-portal-email"},"page":{"$ref":"#/components/schemas/login-portal-page"}},"required":["uid","title","slug","email","page"],"additionalProperties":false},"managed-schema-version":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"version":{"default":"0.0.1","$ref":"#/components/schemas/version"},"yamlSha":{"type":"string","pattern":"^[a-f0-9]{64}$"},"jsonSha":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["uid","createdAt","updatedAt","version"],"additionalProperties":false},"managed-schema-format":{"type":"string","enum":["json","yaml"]},"semver":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"},"doc-source":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"platform"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"git"},"repositoryUid":{"$ref":"#/components/schemas/nanoid"},"path":{"type":"string","minLength":1},"branch":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"publishOnPush":{"default":true,"type":"boolean"},"publishOnMerge":{"default":false,"type":"boolean"},"currentPublishedSha":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"lastPublishedAt":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]}},"required":["type","repositoryUid","path","branch","publishOnPush","publishOnMerge","currentPublishedSha","lastPublishedAt"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"url"},"url":{"type":"string","format":"uri"},"linkedBy":{"type":"string"},"etag":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedAt":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]}},"required":["type","url","linkedBy","etag","lastFetchedAt"],"additionalProperties":false}]},"registry-git-binding":{"type":"object","properties":{"forgejo":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"default":"main","type":"string"}},"required":["owner","repo","branch"],"additionalProperties":false},"publishOnPush":{"default":true,"type":"boolean"},"publishOnMerge":{"default":false,"type":"boolean"},"trackedBranch":{"default":"main","type":"string"},"webhookId":{"default":null,"anyOf":[{"type":"number"},{"type":"null"}]},"external":{"default":null,"anyOf":[{"$ref":"#/components/schemas/registry-git-external"},{"type":"null"}]},"currentPublishedSha":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"lastPublishedAt":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]}},"required":["forgejo","publishOnPush","publishOnMerge","trackedBranch","webhookId","external","currentPublishedSha","lastPublishedAt"],"additionalProperties":false},"registry-git-external":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string","const":"github"},"linkedBy":{"type":"string"},"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string","minLength":2},"branch":{"default":"main","type":"string"},"path":{"default":"","type":"string"},"webhookId":{"default":"","type":"string"}},"required":["provider","linkedBy","installationId","id","name","branch","path","webhookId"],"additionalProperties":false},{"type":"object","properties":{"provider":{"type":"string","const":"bitbucket"},"linkedBy":{"type":"string"},"workspaceUuid":{"type":"string"},"workspaceSlug":{"type":"string"},"repoUuid":{"type":"string"},"repoSlug":{"type":"string"},"name":{"type":"string","minLength":2},"branch":{"default":"main","type":"string"},"webhookUuid":{"default":"","type":"string"}},"required":["provider","linkedBy","workspaceUuid","workspaceSlug","repoUuid","repoSlug","name","branch","webhookUuid"],"additionalProperties":false}]},"workspace-version":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"},"managedDocs":{"type":"array","items":{"$ref":"#/components/schemas/registry-meta"}},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"}},"required":["version","managedDocs","createdAt","updatedAt"],"additionalProperties":false},"registry-meta":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"}},"required":["namespace","slug"],"additionalProperties":false},"workspace":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"namespace":{"$ref":"#/components/schemas/namespace"},"title":{"default":"","type":"string","maxLength":100},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"description":{"default":"","type":"string"},"isPrivate":{"default":false,"type":"boolean"},"pinned":{"default":false,"type":"boolean"},"tags":{"default":[]},"accessGroups":{"default":[]},"loginPortalUid":{"type":"string"},"verifiedContent":{"type":"boolean"},"source":{"default":{"type":"platform"},"$ref":"#/components/schemas/doc-source"},"git":{"anyOf":[{"$ref":"#/components/schemas/registry-git-binding"},{"type":"null"}]},"version":{"$ref":"#/components/schemas/version"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/workspace-version"}}},"required":["uid","createdAt","updatedAt","namespace","title","slug","description","isPrivate","pinned","tags","accessGroups","source","version","versions"],"additionalProperties":false},"registry-publish":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"resourceUid":{"$ref":"#/components/schemas/nanoid"},"asset":{"$ref":"#/components/schemas/registry-asset"},"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"},"version":{"default":null,"anyOf":[{"$ref":"#/components/schemas/version"},{"type":"null"}]},"commitSha":{"type":"string"},"parentSha":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"$ref":"#/components/schemas/registry-publish-source"},"message":{"default":"","type":"string"},"author":{"default":null,"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"}},"required":["name","email"],"additionalProperties":false},{"type":"null"}]}},"required":["uid","createdAt","updatedAt","resourceUid","asset","namespace","slug","version","commitSha","parentSha","source","message","author"],"additionalProperties":false},"registry-asset":{"type":"string","enum":["apis","rules","schemas","sdks","workspaces"]},"registry-publish-source":{"type":"string","enum":["manual","git-hook","external-push","migration"]},"linked-repository":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"remote":{"$ref":"#/components/schemas/linked-repository-remote"},"forgejo":{"default":null,"anyOf":[{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"default":"main","type":"string"}},"required":["owner","repo","branch"],"additionalProperties":false},{"type":"null"}]},"linkedBy":{"type":"string"}},"required":["uid","createdAt","updatedAt","remote","forgejo","linkedBy"],"additionalProperties":false},"linked-repository-remote":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string","const":"github"},"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string","minLength":2},"defaultBranch":{"default":"main","type":"string"}},"required":["provider","installationId","id","name","defaultBranch"],"additionalProperties":false},{"type":"object","properties":{"provider":{"type":"string","const":"bitbucket"},"workspaceUuid":{"type":"string"},"workspaceSlug":{"type":"string"},"repoUuid":{"type":"string"},"repoSlug":{"type":"string"},"name":{"type":"string","minLength":2},"defaultBranch":{"default":"main","type":"string"}},"required":["provider","workspaceUuid","workspaceSlug","repoUuid","repoSlug","name","defaultBranch"],"additionalProperties":false}]},"docs-project-repository-forgejo":{"type":"object","properties":{"provider":{"type":"string","const":"forgejo"},"forgejoOwner":{"type":"string"},"forgejoRepo":{"type":"string"},"branch":{"default":"main","type":"string"},"configPath":{"default":"scalar.config.json","type":"string"}},"required":["provider","forgejoOwner","forgejoRepo","branch","configPath"],"additionalProperties":false},"docs-project-repository-github":{"type":"object","properties":{"provider":{"type":"string","const":"github"},"linkedBy":{"type":"string"},"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string","minLength":2},"repositoryUid":{"default":null,"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"branch":{"default":"main","type":"string"},"configPath":{"default":"scalar.config.json","type":"string"},"publishOnMerge":{"default":true,"type":"boolean"},"publishPreviews":{"default":false,"type":"boolean"},"prComments":{"default":false,"type":"boolean"},"expired":{"default":false,"type":"boolean"}},"required":["provider","linkedBy","installationId","id","name","repositoryUid","branch","configPath","publishOnMerge","publishPreviews","prComments","expired"],"additionalProperties":false},"docs-project-repository-bitbucket":{"type":"object","properties":{"provider":{"type":"string","const":"bitbucket"},"linkedBy":{"type":"string"},"workspaceUuid":{"type":"string"},"workspaceSlug":{"type":"string"},"repoUuid":{"type":"string"},"repoSlug":{"type":"string"},"name":{"type":"string","minLength":2},"repositoryUid":{"default":null,"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"branch":{"default":"main","type":"string"},"configPath":{"default":"scalar.config.json","type":"string"},"publishOnMerge":{"default":true,"type":"boolean"},"publishPreviews":{"default":false,"type":"boolean"},"prComments":{"default":false,"type":"boolean"},"expired":{"default":false,"type":"boolean"},"webhookUuid":{"default":"","type":"string"}},"required":["provider","linkedBy","workspaceUuid","workspaceSlug","repoUuid","repoSlug","name","repositoryUid","branch","configPath","publishOnMerge","publishPreviews","prComments","expired","webhookUuid"],"additionalProperties":false},"docs-project-remote-activity":{"type":"object","properties":{"at":{"$ref":"#/components/schemas/timestamp"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}]},"sha":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["at","branch","sha","actorName"],"additionalProperties":false},"docs-project":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"name":{"type":"string"},"activeDeployment":{"default":null,"anyOf":[{"$ref":"#/components/schemas/active-deployment"},{"type":"null"}]},"lastPublished":{"default":null,"anyOf":[{"$ref":"#/components/schemas/timestamp"},{"type":"null"}]},"lastPublishedUid":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"loginPortalUid":{"default":"","type":"string"},"activeThemeId":{"default":"","type":"string"},"typesenseId":{"type":"number"},"isPrivate":{"default":false,"type":"boolean"},"agentEnabled":{"default":false,"type":"boolean"},"analyticsEnabled":{"default":true,"type":"boolean"},"accessGroups":{"default":[]},"slug":{"$ref":"#/components/schemas/slug"},"publishStatus":{"default":"","type":"string"},"publishMessage":{"default":"","type":"string"},"repository":{"oneOf":[{"$ref":"#/components/schemas/docs-project-repository-forgejo"},{"$ref":"#/components/schemas/docs-project-repository-github"},{"$ref":"#/components/schemas/docs-project-repository-bitbucket"}]},"remoteActivity":{"$ref":"#/components/schemas/docs-project-remote-activity"}},"required":["uid","createdAt","updatedAt","name","activeDeployment","lastPublished","lastPublishedUid","loginPortalUid","activeThemeId","isPrivate","agentEnabled","analyticsEnabled","accessGroups","slug","publishStatus","publishMessage","repository"],"additionalProperties":false},"webhook-event":{"type":"string","enum":["sdk.build.completed"]},"webhook-disabled-reason":{"type":"string","enum":["consecutive-failures"]},"webhook-delivery-status":{"type":"string","enum":["pending","succeeded","failed"]},"sdk-build-outcome":{"type":"string","enum":["succeeded","partial","failed"]},"sdk-build-status":{"type":"string","enum":["pending","error","generated"]},"sdk-build-completed-event":{"type":"object","properties":{"event":{"type":"string","const":"sdk.build.completed"},"createdAt":{"type":"number"},"data":{"type":"object","properties":{"buildUid":{"type":"string"},"status":{"$ref":"#/components/schemas/sdk-build-outcome"},"sdk":{"type":"object","properties":{"uid":{"type":"string"},"namespace":{"type":"string"},"slug":{"type":"string"},"version":{"type":"string"}},"required":["uid","namespace","slug","version"],"additionalProperties":false},"api":{"anyOf":[{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"version":{"type":"string"}},"required":["namespace","slug","version"],"additionalProperties":false},{"type":"null"}]},"targets":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"slug":{"type":"string"},"status":{"$ref":"#/components/schemas/sdk-build-status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["language","slug","status","message"],"additionalProperties":false}}},"required":["buildUid","status","sdk","api","targets"],"additionalProperties":false}},"required":["event","createdAt","data"],"additionalProperties":false}}},"security":[{"BearerAuth":[]}],"paths":{"/me":{"get":{"tags":["auth"],"description":"Get a users basic information","operationId":"getMe","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/user"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/login/email":{"post":{"tags":["auth"],"description":"Login with email password flow","operationId":"postLoginEmail","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/token-response"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"password":{"type":"string"}},"required":["email","password"],"additionalProperties":false}}},"required":true}}},"/login/email-signup":{"post":{"tags":["auth"],"description":"Register with email password flow","operationId":"postLoginEmailSignup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/token-response"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"password":{"type":"string"},"displayName":{"type":"string","maxLength":80},"teamSlug":{"$ref":"#/components/schemas/slug"},"teamName":{"type":"string"},"signupDataUid":{"type":"string"},"teamInvite":{"type":"string"},"otp":{"default":"","type":"string","minLength":6},"otpClientId":{"default":"","type":"string","minLength":6},"flow":{"type":"string","enum":["oss-agent"]}},"required":["email","password","otp","otpClientId"],"additionalProperties":false}}},"required":true}}},"/login/email-otp":{"post":{"tags":["auth"],"description":"Send an OTP verification code to the email","operationId":"postLoginEmailOtp","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"otpClientId":{"type":"string"}},"required":["otpClientId"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"}},"required":["email"],"additionalProperties":false}}},"required":true}}},"/login/email-otp/verify":{"post":{"tags":["auth"],"description":"Verify OTP","operationId":"postLoginEmailOtpVerify","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"otp":{"type":"string","minLength":6,"maxLength":6},"otpClientId":{"type":"string","minLength":6}},"required":["email","otp","otpClientId"],"additionalProperties":false}}},"required":true}}},"/hosting-authenticate":{"get":{"tags":["auth"],"description":"Relays hosting magic links from a Scalar-owned domain to the target docs host.","operationId":"getHostingAuthenticate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"token","required":true}]}},"/login/refresh":{"post":{"tags":["auth"],"description":"Refresh an access token and set the team uid token","operationId":"postLoginRefresh","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/token-response"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"refreshToken":{"type":"string"},"teamUid":{"type":"string"}},"required":["refreshToken"],"additionalProperties":false}}},"required":true}}},"/logout":{"post":{"tags":["auth"],"description":"Log out: revoke the refresh token family and clear the team cookie","operationId":"postLogout","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"refreshToken":{"type":"string"}},"additionalProperties":false}}},"required":true}}},"/login/exchange":{"post":{"tags":["auth"],"description":"Exchange the short lived URL token for access/refresh tokens","operationId":"postLoginExchange","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/token-response"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"exchangeToken":{"type":"string"}},"required":["exchangeToken"],"additionalProperties":false}}},"required":true}}},"/login/get-exchange":{"post":{"tags":["auth"],"description":"Gets an exchange token that can be used to redirect a user with auth credentials to different domain","operationId":"postLoginGetExchange","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"exchangeToken":{"type":"string"}},"required":["exchangeToken"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"],"additionalProperties":false}}},"required":true}}},"/login/request-password-reset":{"post":{"tags":["auth"],"description":"Request reset password","operationId":"postLoginRequestPasswordReset","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"clientId":{"type":"string"}},"required":["email","clientId"],"additionalProperties":false}}},"required":true}}},"/login/reset-password":{"post":{"tags":["auth"],"description":"Verify password reset request","operationId":"postLoginResetPassword","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/token-response"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string"},"resetToken":{"type":"string"},"password":{"type":"string"}},"required":["clientId","resetToken","password"],"additionalProperties":false}}},"required":true}}},"/login/change-password":{"post":{"tags":["auth"],"description":"Change password for authenticated user","operationId":"postLoginChangePassword","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"oldPassword":{"type":"string"},"newPassword":{"type":"string"}},"required":["oldPassword","newPassword"],"additionalProperties":false}}},"required":true}}},"/login/personal-token/generate":{"post":{"tags":["auth"],"description":"Generate a new personal token","operationId":"postLoginPersonalTokenGenerate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"personalToken":{"type":"string"}},"required":["uid","personalToken"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":50},"description":{"type":"string","maxLength":200},"refreshToken":{"type":"string"}},"required":["name","refreshToken"],"additionalProperties":false}}},"required":true}}},"/login/personal-token/access":{"post":{"tags":["auth"],"description":"Generate a new access token from a personal token","operationId":"postLoginPersonalTokenAccess","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string"}},"required":["accessToken"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"personalToken":{"type":"string"}},"required":["personalToken"],"additionalProperties":false}}},"required":true}}},"/login/personal-token/{uid}/revoke":{"post":{"tags":["auth"],"description":"Revoke a personal token","operationId":"postLoginPersonalTokenUidRevoke","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/login/personal-token/{uid}":{"delete":{"tags":["auth"],"description":"Delete a personal token","operationId":"deleteLoginPersonalTokenUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/identity-provider/{uid}":{"get":{"tags":["auth"],"description":"Get an identity provider configuration for a team","operationId":"getIdentityProviderUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/identity-provider-record"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["auth"],"description":"Delete an identity provider configuration for a team","operationId":"deleteIdentityProviderUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/identity-provider":{"post":{"tags":["auth"],"description":"Add an identity provider configuration for a team","operationId":"postIdentityProvider","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/identity-provider-record"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"issuer":{"default":"","description":"This is the URI that identifies your SAML identity provider. Any assertions must use a matching attribute.","type":"string"},"ssoUrl":{"default":"","description":"This URL is used by Scalar to initiate a SAML login.","type":"string"},"x509Cert":{"default":"","description":"The authentication certificate issued by your identity provider","type":"string"},"provider":{"type":"string","enum":["local","google","okta","auth0","azure","one-login","ping-identity"]},"signRequests":{"default":false,"type":"boolean"},"consumerOnly":{"type":"boolean"},"createUsers":{"default":false,"type":"boolean"}},"required":["name","provider","consumerOnly"],"additionalProperties":false}}},"required":true}}},"/identity-provider/update":{"post":{"tags":["auth"],"description":"Update an identity provider configuration for a team","operationId":"postIdentityProviderUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/identity-provider-record"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"name":{"type":"string","minLength":3,"maxLength":50},"ssoUrl":{"type":"string"},"issuer":{"type":"string"},"x509Cert":{"type":"string"},"createUsers":{"type":"boolean"},"signRequests":{"type":"boolean"}},"required":["uid"],"additionalProperties":false}}},"required":true}}},"/saml/metadata":{"get":{"tags":["auth"],"description":"Get base SP SAML metadata","operationId":"getSamlMetadata","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[]}},"/saml/idp/{uid}/metadata":{"get":{"tags":["auth"],"description":"Get SAML IdP-specific connection metadata","operationId":"getSamlIdpUidMetadata","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/saml/idp/{uid}/login":{"get":{"tags":["auth"],"description":"SAML connection login route","operationId":"getSamlIdpUidLogin","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true},{"schema":{"type":"string"},"in":"query","name":"redirect","required":false},{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"query","name":"resource","required":false},{"schema":{"$ref":"#/components/schemas/sso-resource"},"in":"query","name":"type","required":false}]}},"/saml/logout":{"get":{"tags":["auth"],"description":"SAML logout route","operationId":"getSamlLogout","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/saml/acs":{"post":{"tags":["auth"],"description":"SAML ACS route","operationId":"postSamlAcs","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"SAMLResponse":{"type":"string"},"RelayState":{"type":"string"}},"required":["SAMLResponse","RelayState"],"additionalProperties":false}}},"required":true}}},"/saml/initiate":{"post":{"tags":["auth"],"description":"SAML initiate route","operationId":"postSamlInitiate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"array","items":{"type":"object","properties":{"loginUrl":{"type":"string","format":"uri"},"provider":{"type":"string","enum":["local","google","okta","auth0","azure","one-login","ping-identity"]},"teamSlug":{"$ref":"#/components/schemas/slug"}},"required":["loginUrl","provider","teamSlug"],"additionalProperties":false}}},"required":["options"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"}},"required":["email"],"additionalProperties":false}}},"required":true}}},"/saml/cert/signing":{"get":{"tags":["auth"],"description":"Return SAML public signing cert","operationId":"getSamlCertSigning","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[]}},"/saml/cert/encryption":{"get":{"tags":["auth"],"description":"Return SAML public encryption cert","operationId":"getSamlCertEncryption","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[]}},"/docs/version":{"post":{"tags":["docs"],"description":"Creates a new docs version","operationId":"postDocsVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"projectUid":{"$ref":"#/components/schemas/nanoid"},"fromVersionUid":{"$ref":"#/components/schemas/nanoid"}},"required":["name","projectUid"],"additionalProperties":false}}},"required":true}}},"/docs/create-project":{"post":{"tags":["docs"],"description":"Create a WYSIWYG project","operationId":"postDocsCreateProject","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/project"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"hideGuide":{"type":"boolean"},"hideReference":{"type":"boolean"}},"required":["name","hideGuide","hideReference"],"additionalProperties":false}}},"required":true}}},"/docs/delete-project":{"delete":{"tags":["docs"],"description":"Deletes a project","operationId":"deleteDocsDeleteProject","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string"}},"required":["projectId"],"additionalProperties":false}}},"required":true}}},"/docs/duplicate":{"post":{"tags":["docs"],"description":"Duplicates a page","operationId":"postDocsDuplicate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"type":"string"},"versionUid":{"type":"string"},"guideUid":{"type":"string"},"pageUid":{"type":"string"}},"required":["projectUid","versionUid","guideUid","pageUid"],"additionalProperties":false}}},"required":true}}},"/project/update":{"post":{"tags":["docs"],"description":"Update sync or hosted project record","operationId":"postProjectUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"loginPortalUid":{"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"string","const":""}]},"activeThemeId":{"$ref":"#/components/schemas/nanoid"},"isPrivate":{"type":"boolean"},"agentEnabled":{"type":"boolean"},"analyticsEnabled":{"type":"boolean"},"accessGroups":{},"projectUid":{"$ref":"#/components/schemas/nanoid"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/docs/project/change-privacy":{"post":{"tags":["docs"],"description":"Change the private status of a project","operationId":"postDocsProjectChangePrivacy","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"type":"string"},"makePrivate":{"type":"boolean"}},"required":["projectUid","makePrivate"],"additionalProperties":false}}},"required":true}}},"/me/teams":{"get":{"tags":["team"],"description":"List all teams the current user belongs to","operationId":"getMeTeams","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/team-list-mine-entry"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team/slug":{"post":{"tags":["team"],"description":"Update a team slug","operationId":"postTeamSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"],"additionalProperties":false}}},"required":true}}},"/team/slug/available":{"post":{"tags":["team"],"description":"Check if team slug is available","operationId":"postTeamSlugAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isAvailable":{"type":"boolean"}},"required":["isAvailable"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"$ref":"#/components/schemas/slug"}},"required":["slug"],"additionalProperties":false}}},"required":true}}},"/team/create":{"post":{"tags":["team"],"description":"Create a new team","operationId":"postTeamCreate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"teamUid":{"type":"string"}},"required":["teamUid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/project"},"teamInfo":{"type":"object","properties":{"name":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["name"],"additionalProperties":false},"invites":{"type":"array","items":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"role":{"$ref":"#/components/schemas/role"}},"required":["email"],"additionalProperties":false}}},"required":["teamInfo"],"additionalProperties":false}}},"required":true}}},"/team/invite":{"post":{"tags":["team"],"description":"Invite a new member to the team","operationId":"postTeamInvite","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"role":{"$ref":"#/components/schemas/role"}},"required":["email","role"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["team"],"description":"Cancel a team invite","operationId":"deleteTeamInvite","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}},"required":true}},"patch":{"tags":["team"],"description":"Resend an existing team invite","operationId":"patchTeamInvite","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}},"required":true}}},"/team/accept-invite":{"get":{"tags":["team"],"description":"Accept an email team invite","operationId":"getTeamAcceptInvite","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"type":"string"},"in":"query","name":"token","required":true}]}},"/team/rename":{"post":{"tags":["team"],"description":"Rename a team and handle multiple record updates","operationId":"postTeamRename","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false}}},"required":true}}},"/team/image":{"post":{"tags":["team"],"description":"Update a team logo image and handle multiple record updates","operationId":"postTeamImage","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"imageUri":{"type":"string"}},"required":["imageUri"],"additionalProperties":false}}},"required":true}}},"/team/request-unified-docs-migration":{"post":{"tags":["team"],"description":"Queue this team for the move off the legacy WYSIWYG editor. Sets the migration status to `requested`; the migration runner picks it up. Idempotent — pressing it again while queued or running changes nothing.","operationId":"postTeamRequestUnifiedDocsMigration","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["requested","in-progress","completed","failed"]}},"required":["status"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}},"required":true}}},"/team/leave":{"get":{"tags":["team"],"description":"Allow a user to leave a team","operationId":"getTeamLeave","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team":{"delete":{"tags":["team"],"description":"Delete a team","operationId":"deleteTeam","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"newTeamUid":{"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]}},"required":["newTeamUid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team/delete-member":{"post":{"tags":["team"],"description":"Remove a user from the team","operationId":"postTeamDeleteMember","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"}},"required":["userUid"],"additionalProperties":false}}},"required":true}}},"/team/update":{"post":{"tags":["team"],"description":"Update a team record","operationId":"postTeamUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"theme":{"default":"default","type":"string"}},"additionalProperties":false}}},"required":true}}},"/team/update-user":{"post":{"tags":["team"],"description":"Update a team user record (safe properties only)","operationId":"postTeamUpdateUser","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"},"teamUser":{"type":"object","properties":{"displayName":{"type":"string"},"imageUri":{"type":"string"},"activeProjectUid":{"type":"string"}},"additionalProperties":false}},"required":["userUid","teamUser"],"additionalProperties":false}}},"required":true}}},"/team/billing":{"get":{"tags":["team"],"description":"Team billing invoice and plan summary","operationId":"getTeamBilling","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/team-billing-summary"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team/billing/email":{"post":{"tags":["team"],"description":"Update a team's billing email","operationId":"postTeamBillingEmail","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"}},"required":["email"],"additionalProperties":false}}},"required":true}}},"/team/update/plan":{"post":{"tags":["team"],"description":"Update a team's billing plan","operationId":"postTeamUpdatePlan","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"billingPlan":{"anyOf":[{"type":"string","const":"free"},{"type":"string","const":"pro_monthly"},{"type":"string","const":"pro_yearly"}]}},"required":["billingPlan"],"additionalProperties":false}}},"required":true}}},"/team/extend-trial":{"post":{"tags":["team"],"description":"Extend a team's trial once by a few days","operationId":"postTeamExtendTrial","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}},"required":true}}},"/team/update-role":{"post":{"tags":["team"],"description":"Updates user role for a team member","operationId":"postTeamUpdateRole","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"},"role":{"$ref":"#/components/schemas/role"}},"required":["userUid","role"],"additionalProperties":false}}},"required":true}}},"/team/namespace/update":{"post":{"tags":["team"],"description":"Update a team namespace","operationId":"postTeamNamespaceUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"newNamespace":{"$ref":"#/components/schemas/namespace"}},"required":["namespace","newNamespace"],"additionalProperties":false}}},"required":true}}},"/team/namespace":{"post":{"tags":["team"],"description":"Create a team namespace","operationId":"postTeamNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"}},"required":["namespace"],"additionalProperties":false}}},"required":true}}},"/team/namespace/available":{"post":{"tags":["team"],"description":"Check if team namespace is available","operationId":"postTeamNamespaceAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isAvailable":{"type":"boolean"}},"required":["isAvailable"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"}},"required":["namespace"],"additionalProperties":false}}},"required":true}}},"/team/namespaces":{"get":{"tags":["team"],"description":"Get all namespaces for the current team","operationId":"getTeamNamespaces","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/namespace"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team/onboarding/setup":{"post":{"tags":["team"],"description":"Onboarding team setup","operationId":"postTeamOnboardingSetup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"$ref":"#/components/schemas/slug"},"name":{"$ref":"#/components/schemas/team-name"},"imageUri":{"$ref":"#/components/schemas/team-image"},"invites":{"type":"array","items":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"role":{"default":"editor","$ref":"#/components/schemas/role"}},"required":["email","role"],"additionalProperties":false}}},"required":["slug","name","invites"],"additionalProperties":false}}},"required":true}}},"/team/onboarding/complete":{"post":{"tags":["team"],"description":"Onboarding team complete","operationId":"postTeamOnboardingComplete","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/team/icon":{"post":{"tags":["team"],"description":"Adds a custom icon to the team","operationId":"postTeamIcon","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/custom-project-icon"}}},"required":true}},"delete":{"tags":["team"],"description":"Deletes a custom icon from the team","operationId":"deleteTeamIcon","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"src":{"type":"string"}},"required":["src"],"additionalProperties":false}}},"required":true}}},"/team/authentication/domain":{"post":{"tags":["team"],"description":"Add a domain to authentication allowlist","operationId":"postTeamAuthenticationDomain","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["team"],"description":"Remove a domain from authentication allowlist","operationId":"deleteTeamAuthenticationDomain","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}},"required":true}}},"/team/authentication/method":{"post":{"tags":["team"],"description":"Enable or disable authentication method for the team","operationId":"postTeamAuthenticationMethod","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string","enum":["password","google","github","sso"]},"enabled":{"type":"boolean"}},"required":["method","enabled"],"additionalProperties":false}}},"required":true}}},"/team/authentication/user":{"post":{"tags":["team"],"description":"Edit team authentication user controls","operationId":"postTeamAuthenticationUser","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"},"methods":{"type":"object","properties":{"password":{"default":true,"type":"boolean"},"google":{"default":true,"type":"boolean"},"github":{"default":true,"type":"boolean"},"sso":{"default":true,"type":"boolean"}},"additionalProperties":false}},"required":["userUid"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["team"],"description":"Remove team authentication user controls","operationId":"deleteTeamAuthenticationUser","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"}},"required":["userUid"],"additionalProperties":false}}},"required":true}}},"/team/authentication/user/method":{"post":{"tags":["team"],"description":"Enable or disable authentication method for a user","operationId":"postTeamAuthenticationUserMethod","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userUid":{"$ref":"#/components/schemas/nanoid"},"method":{"type":"string","enum":["password","google","github","sso"]},"enabled":{"type":"boolean"}},"required":["userUid","method","enabled"],"additionalProperties":false}}},"required":true}}},"/team/external-access/method":{"post":{"tags":["team"],"description":"Enable or disable external access methods for the team","operationId":"postTeamExternalAccessMethod","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string","enum":["email","sso","google","microsoft"]},"enabled":{"type":"boolean"}},"required":["method","enabled"],"additionalProperties":false}}},"required":true}}},"/feedback":{"post":{"tags":["utility"],"description":"Submit app feedback","operationId":"postFeedback","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"},"feedback":{"type":"string","minLength":5}},"required":["email","feedback"],"additionalProperties":false}}},"required":true}}},"/signup-data":{"post":{"tags":["signup","utility"],"description":"Save docs data on signup","operationId":"postSignupData","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"dataUid":{"type":"string"}},"required":["dataUid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/project-version"},"theme":{"$ref":"#/components/schemas/theme"},"yjsDocs":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"yjsReferences":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["version","yjsDocs","yjsReferences"],"additionalProperties":false}}},"required":true}}},"/waitlist":{"post":{"tags":["waitlist","utility"],"description":"Submit app feedback","operationId":"postWaitlist","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"email":{"$ref":"#/components/schemas/email"},"products":{"type":"array","items":{"type":"string","enum":["client"]}}},"required":["email","products"],"additionalProperties":false}}},"required":true}}},"/stripe":{"post":{"tags":["payment"],"description":"Stripe webhook handling","operationId":"postStripe","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/object"}}},"required":true}}},"/payment/start":{"post":{"tags":["payment"],"description":"Create a new stripe checkout session or redirect to the customer billing portal.","operationId":"postPaymentStart","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"billingPlan":{"anyOf":[{"type":"string","const":"pro_monthly"},{"type":"string","const":"pro_yearly"}]},"redirectUrl":{"type":"string"},"flow":{"type":"string","enum":["oss-agent"]}},"required":["billingPlan"],"additionalProperties":false}}},"required":true}}},"/payment/billing/start":{"post":{"tags":["payment"],"description":"Create a stripe management session for billing management","operationId":"postPaymentBillingStart","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethod":{"type":"boolean"}},"additionalProperties":false}}},"required":true}}},"/github/authorize":{"get":{"tags":["github"],"description":"Get and save a user github token to their database object. This allows subsequent queries for github data from the users scope.","operationId":"getGithubAuthorize","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"type":"string"},"in":"query","name":"code","required":true},{"schema":{"type":"string"},"in":"query","name":"state","required":true}]}},"/github/link/initiate":{"get":{"tags":["github"],"description":"Issue a signed OAuth state token for the GitHub user-authorization flow and return the GitHub authorize URL the client should redirect to. Optionally remembers a dashboard path to return the user to after the round-trip.","operationId":"getGithubLinkInitiate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"query","name":"redirect","required":false}]}},"/github/repos":{"get":{"tags":["github"],"description":"Get a list of repositories that can be linked to a project","operationId":"getGithubRepos","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/github-install"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/github/repos/{id}":{"get":{"tags":["github"],"description":"Get repository info","operationId":"getGithubReposId","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"private":{"type":"boolean"},"url":{"type":"string"},"src":{"type":"string"}},"required":["name","private","url"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"number"},"in":"path","name":"id","required":true}]}},"/github/installs":{"get":{"tags":["github"],"description":"List GitHub App installations the user can link a project to","operationId":"getGithubInstalls","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"icon":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/github/installs/{installationId}/repos":{"get":{"tags":["github"],"description":"List a single page of repositories for a GitHub installation","operationId":"getGithubInstallsInstallationIdRepos","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"repos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"totalCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["repos","hasMore","totalCount"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"number"},"in":"path","name":"installationId","required":true},{"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"in":"query","name":"page","required":true},{"schema":{"default":30,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"perPage","required":true}]}},"/github/link-repo":{"post":{"tags":["github"],"description":"Links a github repo to a Scalar github project","operationId":"postGithubLinkRepo","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"repositoryId":{"type":"number"},"configPath":{"default":"","type":"string"},"branch":{"type":"string"},"publishOnMerge":{"type":"boolean"},"publishPreviews":{"default":false,"type":"boolean"},"prComments":{"default":false,"type":"boolean"},"isPrivate":{"default":false,"type":"boolean"},"accessGroups":{"default":[],"type":"array","items":{"type":"string"}}},"required":["uid","repositoryId","configPath","branch","publishOnMerge","publishPreviews","prComments","isPrivate","accessGroups"],"additionalProperties":false}}},"required":true}}},"/github/docs-project/{uid}/commits":{"get":{"tags":["github"],"description":"List commits from the GitHub repo backing a `provider: github` DocsProject","operationId":"getGithubDocsProjectUidCommits","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"sha":{"type":"string"},"message":{"type":"string"},"authorName":{"type":"string"},"authorEmail":{"type":"string"},"timestamp":{"type":"number"}},"required":["sha","message","authorName","authorEmail","timestamp"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true},{"schema":{"type":"string"},"in":"query","name":"branch","required":false},{"schema":{"default":1,"type":"number"},"in":"query","name":"page","required":true},{"schema":{"default":50,"type":"number"},"in":"query","name":"perPage","required":true}]}},"/github/docs-project/{uid}/branches":{"get":{"tags":["github"],"description":"List branches on the GitHub repo backing a `provider: github` DocsProject. Supports prefix search.","operationId":"getGithubDocsProjectUidBranches","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["name","isDefault"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["branches","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true},{"schema":{"type":"string"},"in":"query","name":"query","required":false},{"schema":{"default":1,"type":"number"},"in":"query","name":"page","required":true},{"schema":{"default":100,"type":"number"},"in":"query","name":"perPage","required":true}]}},"/github/docs-project/{uid}/pull-request":{"post":{"tags":["github"],"description":"Create a pull request on the GitHub repo backing a `provider: github` DocsProject","operationId":"postGithubDocsProjectUidPullRequest","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"number"},"alreadyExists":{"type":"boolean"}},"required":["url","number","alreadyExists"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"head":{"type":"string","minLength":1},"base":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"body":{"type":"string"},"draft":{"default":false,"type":"boolean"}},"required":["head","base","title","draft"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true}]}},"/github/docs-project/{uid}/pull-request/for-branch":{"get":{"tags":["github"],"description":"Look up the open pull request for a branch on the GitHub repo backing a `provider: github` DocsProject","operationId":"getGithubDocsProjectUidPullRequestForBranch","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"pullRequest":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"number"},"title":{"type":"string"},"body":{"type":"string"}},"required":["url","number","title","body"],"additionalProperties":false},{"type":"null"}]}},"required":["pullRequest"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true},{"schema":{"type":"string","minLength":1},"in":"query","name":"branch","required":true}]}},"/github/slug/available":{"post":{"tags":["github"],"description":"Check if github slug is available","operationId":"postGithubSlugAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isAvailable":{"type":"boolean"}},"required":["isAvailable"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"$ref":"#/components/schemas/slug"}},"required":["slug"],"additionalProperties":false}}},"required":true}}},"/github/slug":{"post":{"tags":["github"],"description":"Update a github project slug","operationId":"postGithubSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"slug":{"type":"string"}},"required":["uid","slug"],"additionalProperties":false}}},"required":true}}},"/github/create":{"post":{"tags":["github"],"description":"Create a github project that is not linked to a github repo. This project will be used by the cli flow.","operationId":"postGithubCreate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"slug":{"type":"string"}},"required":["uid","slug"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"},"isPrivate":{"default":false,"type":"boolean"},"allowedUsers":{"default":[],"type":"array","items":{"type":"string"}},"allowedDomains":{"default":[],"type":"array","items":{"type":"string"}},"accessGroups":{"default":[],"type":"array","items":{"type":"string"}},"repositoryId":{"type":"number"}},"required":["name","isPrivate","allowedUsers","allowedDomains","accessGroups"],"additionalProperties":false}}},"required":true}}},"/github/unlink-repo":{"post":{"tags":["github"],"description":"Unlink a github repo from a Scalar github project","operationId":"postGithubUnlinkRepo","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}},"required":true}}},"/github/config/validate":{"post":{"tags":["github"],"description":"Validate configuration file for a github project","operationId":"postGithubConfigValidate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"config":{"type":"string"},"success":{"type":"boolean","const":true},"version":{"type":"string"},"path":{"type":"string"}},"required":["config","success"],"additionalProperties":false},{"type":"object","properties":{"config":{"type":"string"},"error":{"type":"array","items":{"type":"string"}},"success":{"type":"boolean","const":false},"version":{"type":"string"},"path":{"type":"string"}},"required":["config","error","success"],"additionalProperties":false}]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string"},"configPath":{"type":"string"}},"required":["projectId"],"additionalProperties":false}}},"required":true}}},"/github/{slug}":{"get":{"tags":["github"],"description":"Get a github project.","operationId":"getGithubSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/github-project"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/github/list-projects":{"get":{"tags":["github"],"description":"Get github projects for the team","operationId":"getGithubListProjects","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/github-project"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/github/delete":{"post":{"tags":["github"],"description":"Deletes a GitHub project","operationId":"postGithubDelete","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"type":"string"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/vcs/bitbucket/authorize":{"get":{"tags":["vcs"],"description":"Get and save a user Bitbucket token to their database object. This allows subsequent queries for Bitbucket data from the user scope.","operationId":"getVcsBitbucketAuthorize","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"type":"string"},"in":"query","name":"code","required":true},{"schema":{"type":"string"},"in":"query","name":"state","required":true}]}},"/vcs/bitbucket/link/initiate":{"get":{"tags":["vcs"],"description":"Issue a signed OAuth state token for the Bitbucket user-authorization flow and return the Bitbucket authorize URL the client should redirect to. Optionally remembers a dashboard path to return the user to after the round-trip.","operationId":"getVcsBitbucketLinkInitiate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"query","name":"redirect","required":false}]}},"/vcs/bitbucket/workspaces":{"get":{"tags":["vcs"],"description":"List the calling user's Bitbucket workspaces and the repositories they can write to. Used by the link-to-Bitbucket UI.","operationId":"getVcsBitbucketWorkspaces","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"iconUrl":{"type":"string"},"repos":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"fullName":{"type":"string"},"defaultBranch":{"type":"string"},"isPrivate":{"type":"boolean"},"workspaceUuid":{"type":"string"},"workspaceSlug":{"type":"string"}},"required":["uuid","slug","fullName","defaultBranch","isPrivate","workspaceUuid","workspaceSlug"],"additionalProperties":false}}},"required":["uuid","slug","name","repos"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/vcs/bitbucket/docs-project/{uid}/branches":{"get":{"tags":["vcs"],"description":"List branches on the Bitbucket repo backing a `provider: 'bitbucket'` DocsProject. Supports prefix search via the `query` param.","operationId":"getVcsBitbucketDocsProjectUidBranches","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["name","isDefault"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["branches","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true},{"schema":{"type":"string"},"in":"query","name":"query","required":false},{"schema":{"default":1,"type":"number"},"in":"query","name":"page","required":true},{"schema":{"default":100,"type":"number"},"in":"query","name":"perPage","required":true}]}},"/vcs/bitbucket/disconnect-account":{"post":{"tags":["vcs"],"description":"Wipe the calling user's Bitbucket OAuth tokens. Any DocsProjects this user linked will lose their token and need to be re-linked or have the linker swap accounts on Bitbucket.","operationId":"postVcsBitbucketDisconnectAccount","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/vcs/github/disconnect-account":{"post":{"tags":["vcs"],"description":"Wipe the calling user's GitHub OAuth tokens. Any DocsProjects this user linked will lose their token; the user can reconnect at any time.","operationId":"postVcsGithubDisconnectAccount","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/registry/{asset}/{namespace}/{slug}/instances":{"get":{"tags":["api-docs"],"description":"Content instances for a registry document, newest first","operationId":"getRegistryAssetNamespaceSlugInstances","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"instances":{"type":"array","items":{"$ref":"#/components/schemas/doc-instance"}},"tracked":{"type":"boolean"}},"required":["instances","tracked"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"query","name":"version","required":false},{"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"in":"query","name":"page","required":true},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"perPage","required":true}]}},"/registry/{asset}/{namespace}/{slug}/versions":{"get":{"tags":["api-docs"],"description":"Version records for a registry document, with their chain heads","operationId":"getRegistryAssetNamespaceSlugVersions","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"versions":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"version":{"$ref":"#/components/schemas/version"},"upgraded":{"default":false,"type":"boolean"},"embedStatus":{"default":null,"anyOf":[{"type":"string","enum":["complete","failed"]},{"type":"null"}]},"tags":{"default":[],"type":"array","items":{"type":"string"}},"tools":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"method":{"$ref":"#/components/schemas/method"},"enabledTools":{"type":"array","items":{"type":"string","enum":["execute-request","get-mini-openapi-spec"]}}},"required":["path","method","enabledTools"],"additionalProperties":false}},{"type":"null"}]},"jsonSha":{"anyOf":[{"type":"string"},{"type":"null"}]},"yamlSha":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["uid","createdAt","updatedAt","version","upgraded","embedStatus","tags","jsonSha","yamlSha"],"additionalProperties":false}}},"required":["versions"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry/{asset}/{namespace}/{slug}/instances/{jsonSha}/content":{"get":{"tags":["api-docs"],"description":"A content instance's stored document","operationId":"getRegistryAssetNamespaceSlugInstancesJsonShaContent","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"format":{"type":"string","enum":["json","yaml"]},"jsonSha":{"type":"string"}},"required":["content","format","jsonSha"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"jsonSha","required":true},{"schema":{"default":"json","type":"string","enum":["json","yaml"]},"in":"query","name":"format","required":true}]}},"/registry/{asset}/{namespace}/{slug}/versions/{version}/active":{"post":{"tags":["api-docs"],"description":"Roll a version tag back to an earlier content instance","operationId":"postRegistryAssetNamespaceSlugVersionsVersionActive","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonSha":{"type":"string"},"changed":{"type":"boolean"}},"required":["jsonSha","changed"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"instanceUid":{"$ref":"#/components/schemas/nanoid"}},"required":["instanceUid"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"version","required":true}]}},"/registry/{asset}/{namespace}/{slug}/source/url":{"post":{"tags":["api-docs"],"description":"Link a source URL as the document’s source of truth. The platform keeps a read-only mirror.","operationId":"postRegistryAssetNamespaceSlugSourceUrl","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["version"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry/{asset}/{namespace}/{slug}/source/refresh":{"post":{"tags":["api-docs"],"description":"Re-fetch a URL-sourced document and ingest the content when it changed upstream.","operationId":"postRegistryAssetNamespaceSlugSourceRefresh","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"refreshed":{"type":"boolean"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["refreshed","version"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/managed-doc/access-group":{"post":{"tags":["api-docs"],"description":"Adds an access group to a managed doc","operationId":"postManagedDocAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["api-docs"],"description":"Removes an access group from a managed doc","operationId":"deleteManagedDocAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}}},"/managed-doc/available":{"post":{"tags":["api-docs"],"description":"Checks if a registry slug is available","operationId":"postManagedDocAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["namespace","slug"],"additionalProperties":false}}},"required":true}}},"/managed-doc/{namespace}":{"get":{"tags":["api-docs"],"description":"Get a list of all documents for the namespace","operationId":"getManagedDocNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"version":{"$ref":"#/components/schemas/version"},"title":{"default":"","type":"string","maxLength":100},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"description":{"default":"","type":"string"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"default":false,"type":"boolean"},"tags":{"default":[]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/managed-doc-version"}}},"required":["uid","version","title","slug","description","namespace","isPrivate","tags","versions"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]},"post":{"tags":["api-docs"],"description":"Creates a new api document for the namespace","operationId":"postManagedDocNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"versionUid":{"type":"string"},"title":{"type":"string"},"jsonSha":{"type":"string"},"yamlSha":{"type":"string"},"versionSha":{"type":"string"}},"required":["uid","versionUid","title","jsonSha","yamlSha","versionSha"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":3},"description":{"type":"string"},"version":{"$ref":"#/components/schemas/version"},"document":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"},"ruleset":{"type":"string"},"isPrivate":{"type":"boolean"},"docsProjectUid":{"$ref":"#/components/schemas/nanoid"}},"required":["title","version","document","slug"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]}},"/managed-doc/{namespace}/{slug}":{"patch":{"tags":["api-docs"],"description":"Update metadata for a specific managed document","operationId":"patchManagedDocNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"isPrivate":{"type":"boolean"},"pinned":{"type":"boolean"},"version":{"$ref":"#/components/schemas/version"},"ruleset":{"type":"string"},"agentEnabled":{"type":"boolean"},"theme":{"type":"string"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"delete":{"tags":["api-docs"],"description":"Delete a specific managed document and all of the related versions","operationId":"deleteManagedDocNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"get":{"tags":["api-docs"],"description":"Get a specific managed document","operationId":"getManagedDocNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"version":{"$ref":"#/components/schemas/version"},"title":{"default":"","type":"string","maxLength":100},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"description":{"default":"","type":"string"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"default":false,"type":"boolean"},"tags":{"default":[]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/managed-doc-version"}}},"required":["uid","version","title","slug","description","namespace","isPrivate","tags","versions"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/managed-doc/{namespace}/{slug}/version/{semver}":{"get":{"tags":["api-docs"],"description":"Get a specific managed document version stream","operationId":"getManagedDocNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true},{"schema":{"type":"string","const":"processed"},"in":"query","name":"variant","required":false}]},"patch":{"tags":["api-docs"],"description":"Update the registry file content for the doc version","operationId":"patchManagedDocNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonSha":{"type":"string"},"yamlSha":{"type":"string"},"versionSha":{"type":"string"}},"required":["jsonSha","yamlSha","versionSha"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"string"}},"required":["document"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]},"delete":{"tags":["api-docs"],"description":"Delete a specific managed document version","operationId":"deleteManagedDocNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]}},"/managed-doc/{namespace}/{slug}/version/{semver}/metadata":{"get":{"tags":["api-docs"],"description":"Get metadata for a specific api document version","operationId":"getManagedDocNamespaceSlugVersionSemverMetadata","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/managed-doc-version"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]}},"/managed-doc/{namespace}/{slug}/version":{"post":{"tags":["api-docs"],"description":"Create a new api document version","operationId":"postManagedDocNamespaceSlugVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/managed-doc-version"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"},"document":{"type":"string"},"force":{"type":"boolean"},"isCurrent":{"default":true,"type":"boolean"},"docsProjectUid":{"$ref":"#/components/schemas/nanoid"}},"required":["version","document","isCurrent"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/managed-doc":{"get":{"tags":["api-docs"],"description":"Get a list of all documents for a team","operationId":"getManagedDoc","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"version":{"$ref":"#/components/schemas/version"},"title":{"default":"","type":"string","maxLength":100},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"description":{"default":"","type":"string"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"default":false,"type":"boolean"},"tags":{"default":[]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/managed-doc-version"}}},"required":["uid","version","title","slug","description","namespace","isPrivate","tags","versions"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/managed-doc/{namespace}/{slug}/version/{semver}/tools":{"post":{"tags":["api-docs"],"description":"Update managed docs MCP tools.","operationId":"postManagedDocNamespaceSlugVersionSemverTools","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"method":{"$ref":"#/components/schemas/method"},"enabledTools":{"type":"array","items":{"type":"string","enum":["execute-request","get-mini-openapi-spec"]}}},"required":["path","method","enabledTools"],"additionalProperties":false}}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]}},"/rulesets/{namespace}/{slug}":{"get":{"tags":["rules"],"description":"Get a the rule document","operationId":"getRulesetsNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"patch":{"tags":["rules"],"description":"Update rule metadata","operationId":"patchRulesetsNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"isPrivate":{"type":"boolean"},"blockPublishOn":{"type":"string","enum":["error","warning","info","hint","none"]}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"delete":{"tags":["rules"],"description":"Delete a specific rule","operationId":"deleteRulesetsNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/rulesets/get-by-id/{uid}":{"get":{"tags":["rules"],"description":"Get a the rule document","operationId":"getRulesetsGetByIdUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"uid","required":true}]}},"/rulesets/{namespace}":{"get":{"tags":["rules"],"description":"Get a list of all rulesets for the namespace","operationId":"getRulesetsNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"title":{"default":"","type":"string","maxLength":100},"description":{"default":"","type":"string"},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"default":false,"type":"boolean"}},"required":["uid","title","description","slug","namespace","isPrivate"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]},"post":{"tags":["rules"],"description":"Create a new rule for the namespace","operationId":"postRulesetsNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"isPrivate":{"type":"boolean"},"blockPublishOn":{"type":"string","enum":["error","warning","info","hint","none"]},"document":{"type":"string"}},"required":["title","slug"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]}},"/rulesets/upload":{"post":{"tags":["rules"],"description":"Update rule content","operationId":"postRulesetsUpload","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"data":{"type":"string"}},"required":["uid","data"],"additionalProperties":false}}},"required":true}}},"/rules/access-group":{"post":{"tags":["rules"],"description":"Adds an access group to a rule","operationId":"postRulesAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["rules"],"description":"Removes an access group from a rule","operationId":"deleteRulesAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}}},"/rulesets/check-slug":{"post":{"tags":["rules"],"description":"Checks if a ruleset slug is available for the provided namespace","operationId":"postRulesetsCheckSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["namespace","slug"],"additionalProperties":false}}},"required":true}}},"/publish/dns-check":{"post":{"tags":["publish"],"description":"Reports whether a custom domain points at Scalar yet","operationId":"postPublishDnsCheck","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["verified","pending","misconfigured"]},"expected":{"type":"object","properties":{"type":{"type":"string","const":"CNAME"},"target":{"type":"string"}},"required":["type","target"],"additionalProperties":false},"found":{"type":"array","items":{"type":"string"}}},"required":["status","expected","found"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":1,"maxLength":253}},"required":["domain"],"additionalProperties":false}}},"required":true}}},"/unpublish":{"delete":{"tags":["publish"],"description":"Removes the active deploy from a project, without deleting cached assets","operationId":"deleteUnpublish","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"type":"string"},"githubProjectUid":{"type":"string"},"unifiedProjectUid":{"type":"string"}},"additionalProperties":false}}},"required":true}}},"/publish":{"delete":{"tags":["publish"],"description":"Delete a publish record and its cached assets","operationId":"deletePublish","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"publishUid":{"type":"string"}},"required":["publishUid"],"additionalProperties":false}}},"required":true}}},"/publish/redeploy":{"post":{"tags":["publish"],"description":"Redeploy a previous publish","operationId":"postPublishRedeploy","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"publishUid":{"type":"string"}},"required":["publishUid"],"additionalProperties":false}}},"required":true}}},"/publish/bulk":{"delete":{"tags":["publish"],"description":"Bulk delete all non-deployed publish records","operationId":"deletePublishBulk","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"type":"string"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/publish/cancel":{"post":{"tags":["publish"],"description":"Cancel an in-flight publish before it goes live","operationId":"postPublishCancel","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"publishUid":{"type":"string"}},"required":["publishUid"],"additionalProperties":false}}},"required":true}}},"/publish/logs/{publishUid}":{"get":{"tags":["publish"],"description":"Checks & creates a publish record for a CLI publish","operationId":"getPublishLogsPublishUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"publishUid","required":true}]}},"/publish/domains/availability":{"post":{"tags":["publish"],"description":"Checks availability for publish domain","operationId":"postPublishDomainsAvailability","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}},"required":true}}},"/publish/domains/project":{"post":{"tags":["publish"],"description":"Returns active domains for a project","operationId":"postPublishDomainsProject","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"scalarDomain":{"anyOf":[{"type":"string"},{"type":"null"}]},"customDomain":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["scalarDomain","customDomain"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"$ref":"#/components/schemas/nanoid"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/publish/deploy-check":{"get":{"tags":["publish"],"description":"Verifies a specific site is deployed and SSL certificates can be issued for it. ","operationId":"getPublishDeployCheck","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"parameters":[{"schema":{"type":"string"},"in":"query","name":"domain","required":true}]}},"/v1/access-groups/{slug}":{"get":{"tags":["access-groups"],"description":"Get an access group by slug","operationId":"getV1AccessGroupsSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"name":{"default":"","$ref":"#/components/schemas/access-group-name"},"slug":{"default":"randomAccessGroupSlug()","$ref":"#/components/schemas/slug"},"allowedDomains":{"default":[]},"allowedEmails":{"default":[]}},"required":["uid","name","slug","allowedDomains","allowedEmails"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/v1/access-groups":{"post":{"tags":["access-groups"],"description":"Creates an access group","operationId":"postV1AccessGroups","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/access-group"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"$ref":"#/components/schemas/access-group-name"},"slug":{"$ref":"#/components/schemas/slug"},"allowedDomains":{},"allowedEmails":{}},"additionalProperties":false}}},"required":true}}},"/v1/access-groups/{uid}":{"delete":{"tags":["access-groups"],"description":"Deletes an access group by UID","operationId":"deleteV1AccessGroupsUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"patch":{"tags":["access-groups"],"description":"Updates an access group by UID","operationId":"patchV1AccessGroupsUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"$ref":"#/components/schemas/access-group-name"},"slug":{"$ref":"#/components/schemas/slug"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/access-groups/{uid}/emails":{"post":{"tags":["access-groups"],"description":"Adds a new email to an access group","operationId":"postV1AccessGroupsUidEmails","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"}},"required":["email"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["access-groups"],"description":"Removes an existing email from an access group","operationId":"deleteV1AccessGroupsUidEmails","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"$ref":"#/components/schemas/email"}},"required":["email"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/access-groups/{uid}/domains":{"post":{"tags":["access-groups"],"description":"Adds a new domain to an access group","operationId":"postV1AccessGroupsUidDomains","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"$ref":"#/components/schemas/email-domain"}},"required":["domain"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["access-groups"],"description":"Removes an existing domain from an access group","operationId":"deleteV1AccessGroupsUidDomains","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"$ref":"#/components/schemas/email-domain"}},"required":["domain"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/login-portals/{slug}":{"get":{"tags":["login-portals"],"description":"Get a login portal","operationId":"getLoginPortalsSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/login-portal"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/login-portals":{"get":{"tags":["login-portals"],"description":"Get a list of all login portals for the team","operationId":"getLoginPortals","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"title":{"type":"string","maxLength":200},"slug":{"$ref":"#/components/schemas/slug"}},"required":["uid","title","slug"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}},"post":{"tags":["login-portals"],"description":"Create a new login portal for the team","operationId":"postLoginPortals","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"slug":{"type":"string"},"email":{"$ref":"#/components/schemas/login-portal-email"},"page":{"$ref":"#/components/schemas/login-portal-page"}},"required":["title","slug","email","page"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["login-portals"],"description":"Delete a specific login portal","operationId":"deleteLoginPortals","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"],"additionalProperties":false}}},"required":true}}},"/login-portals/update":{"post":{"tags":["login-portals"],"description":"Update login portals metadata","operationId":"postLoginPortalsUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"}},"required":["slug"],"additionalProperties":false}}},"required":true}}},"/schemas/check-slug":{"post":{"tags":["schemas"],"description":"Checks if a schema slug is available","operationId":"postSchemasCheckSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["namespace","slug"],"additionalProperties":false}}},"required":true}}},"/schemas/access-group":{"post":{"tags":["schemas"],"description":"Adds an access group to a managed schema","operationId":"postSchemasAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["schemas"],"description":"Removes an access group from a managed schema","operationId":"deleteSchemasAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["namespace","slug","groupUid"],"additionalProperties":false}}},"required":true}}},"/schemas/{namespace}":{"get":{"tags":["schemas"],"description":"Get a list of all schemas for the namespace","operationId":"getSchemasNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"title":{"default":"","type":"string","maxLength":100},"description":{"default":"","type":"string"},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"default":false,"type":"boolean"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/managed-schema-version"}}},"required":["uid","title","description","slug","namespace","isPrivate","versions"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]},"post":{"tags":["schemas"],"description":"Creates a managed schema","operationId":"postSchemasNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"version":{"$ref":"#/components/schemas/version"},"slug":{"type":"string"},"isPrivate":{"type":"boolean"},"document":{"type":"string"}},"required":["title","version","slug"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true}]}},"/schemas/{namespace}/{slug}":{"patch":{"tags":["schemas"],"description":"Update schema metadata","operationId":"patchSchemasNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"version":{"$ref":"#/components/schemas/version"},"isPrivate":{"type":"boolean"},"pinned":{"type":"boolean"},"format":{"$ref":"#/components/schemas/managed-schema-format"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"delete":{"tags":["schemas"],"description":"Delete a specific schema and all of the related versions","operationId":"deleteSchemasNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/schemas/{namespace}/{slug}/version/{semver}":{"get":{"tags":["schemas"],"description":"Get a specific schema document","operationId":"getSchemasNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]},"post":{"tags":["schemas"],"description":"Update managed schema content in GCS","operationId":"postSchemasNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonSha":{"type":"string"}},"required":["jsonSha"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"}},"required":["content"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]},"delete":{"tags":["schemas"],"description":"Delete a specific schema version","operationId":"deleteSchemasNamespaceSlugVersionSemver","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"path","name":"semver","required":true}]}},"/schemas/{namespace}/{slug}/version":{"post":{"tags":["schemas"],"description":"Create a new schema version","operationId":"postSchemasNamespaceSlugVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"},"document":{"type":"string"},"force":{"type":"boolean"}},"required":["document"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/schemas/{namespace}/{slug}/version/{version}/duplicate":{"post":{"tags":["schemas"],"description":"Duplicate schema version","operationId":"postSchemasNamespaceSlugVersionVersionDuplicate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"}},"required":["version"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"$ref":"#/components/schemas/version"},"in":"path","name":"version","required":true}]}},"/v1/sdks/sync":{"post":{"tags":["sdks"],"description":"Manually trigger git sync for one language target of a build","operationId":"postV1SdksSync","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"buildUid":{"$ref":"#/components/schemas/nanoid"},"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"required":["buildUid","language"],"additionalProperties":false}}},"required":true}}},"/v1/sdks":{"post":{"tags":["sdks"],"description":"Creates a new SDK with one or more language targets","operationId":"postV1Sdks","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"apiUid":{"$ref":"#/components/schemas/nanoid"},"languages":{"minItems":1,"type":"array","items":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"slug":{"$ref":"#/components/schemas/slug"},"className":{"type":"string"},"config":{"type":"string"}},"required":["apiUid","languages"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/version":{"post":{"tags":["sdks"],"description":"Creates a new user-specified version for an SDK","operationId":"postV1SdksVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sdkUid":{"$ref":"#/components/schemas/nanoid"},"apiVersion":{"$ref":"#/components/schemas/version"},"version":{"$ref":"#/components/schemas/semver"}},"required":["sdkUid","apiVersion","version"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["sdks"],"description":"Delete a version of an SDK","operationId":"deleteV1SdksVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"version":{"$ref":"#/components/schemas/version"}},"required":["uid","version"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/{uid}":{"patch":{"tags":["sdks"],"description":"Update an SDK by UID","operationId":"patchV1SdksUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"config":{"type":"string"},"baseConfig":{"type":"string"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"type":"boolean"},"description":{"type":"string"},"currentVersion":{"$ref":"#/components/schemas/nanoid"},"slug":{"$ref":"#/components/schemas/slug"},"apiUid":{"anyOf":[{"$ref":"#/components/schemas/nanoid"},{"type":"null"}]},"apiVersion":{"anyOf":[{"$ref":"#/components/schemas/version"},{"type":"null"}]},"configSource":{"type":"string","enum":["project"]}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["sdks"],"description":"Delete an SDK by UID","operationId":"deleteV1SdksUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/sdks/bulk":{"post":{"tags":["sdks"],"description":"Deprecated: creates one multi-target SDK from a registry API","operationId":"postV1SdksBulk","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uids":{"type":"array","items":{"$ref":"#/components/schemas/nanoid"}}},"required":["uids"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiUid":{"$ref":"#/components/schemas/nanoid"},"languages":{"minItems":1,"type":"array","items":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"className":{"type":"string"}},"required":["apiUid","languages"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/available":{"post":{"tags":["sdks"],"description":"Checks if an SDK slug is available","operationId":"postV1SdksAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"$ref":"#/components/schemas/namespace"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["namespace","slug"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/registry/availability":{"post":{"tags":["sdks"],"description":"Checks whether a package name is free on the registry for a language","operationId":"postV1SdksRegistryAvailability","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["available","taken","unsupported","invalid"]}},"required":["registry","status"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]},"packageName":{"type":"string","minLength":1,"maxLength":214}},"required":["language","packageName"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/resolve-config":{"post":{"tags":["sdks"],"description":"Resolve a complete SDK config against its API document","operationId":"postV1SdksResolveConfig","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"string"}},"required":["config"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"apiUid":{"$ref":"#/components/schemas/nanoid"},"languages":{"minItems":1,"type":"array","items":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"slug":{"$ref":"#/components/schemas/slug"},"config":{"type":"string"}},"required":["apiUid","languages","slug"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/{uid}/access-group":{"post":{"tags":["sdks"],"description":"Adds an access group to an SDK","operationId":"postV1SdksUidAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["groupUid"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["sdks"],"description":"Removes an access group from an SDK","operationId":"deleteV1SdksUidAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"groupUid":{"$ref":"#/components/schemas/nanoid"}},"required":["groupUid"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/sdks/repository":{"post":{"tags":["sdks"],"description":"Links an SDK language target to a github repository","operationId":"postV1SdksRepository","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"repo":{"type":"string"},"branch":{"type":"string"}},"required":["repo","branch"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]},"repositoryId":{"type":"number"},"baseBranch":{"type":"string"},"prereleaseType":{"type":"string","pattern":"^[A-Za-z][0-9A-Za-z-]*$"}},"required":["uid","language","repositoryId","baseBranch"],"additionalProperties":false}}},"required":true}},"delete":{"tags":["sdks"],"description":"Unlinks an SDK language target repository","operationId":"deleteV1SdksRepository","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"required":["uid","language"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/repository/update":{"post":{"tags":["sdks"],"description":"Updates an SDK target repository metadata","operationId":"postV1SdksRepositoryUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]},"baseBranch":{"type":"string"},"prereleaseType":{"anyOf":[{"type":"string","pattern":"^[A-Za-z][0-9A-Za-z-]*$"},{"type":"null"}]}},"required":["uid","language"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/repository/publishing":{"post":{"tags":["sdks"],"description":"Toggles publish-on-merge and registry auth for an SDK target","operationId":"postV1SdksRepositoryPublishing","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]},"publishOnMerge":{"type":"boolean"},"authMethod":{"type":"string","enum":["oidc","access-token"]}},"required":["uid","language","publishOnMerge"],"additionalProperties":false}}},"required":true}}},"/v1/sdks/{uid}/draft":{"delete":{"tags":["sdks"],"description":"Discard the open draft version of an SDK","operationId":"deleteV1SdksUidDraft","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/sdks/{uid}/sample/access":{"post":{"tags":["sdks"],"description":"Invites the caller to the SDK sample repositories","operationId":"postV1SdksUidSampleAccess","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"object","properties":{"repository":{"type":"string"},"invitationUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"failure":{"type":"string","enum":["missing","forbidden","unavailable"]}},"required":["repository","invitationUrl"],"additionalProperties":false}}},"required":["repositories"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/sdks/{uid}/sample/retry":{"post":{"tags":["sdks"],"description":"Retry provisioning the SDK sample repositories","operationId":"postV1SdksUidSampleRetry","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/sdks/repository/release-pr":{"get":{"tags":["sdks"],"description":"Get the release PR open on an SDK target's repository","operationId":"getV1SdksRepositoryReleasePr","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"pullRequest":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["pullRequest"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"query","name":"uid","required":true},{"schema":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]},"in":"query","name":"language","required":true}]}},"/v1/sdks/build":{"post":{"tags":["sdks"],"description":"Trigger a manual multi-language SDK build","operationId":"postV1SdksBuild","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"}},"required":["version"],"additionalProperties":false},{"type":"null"}]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sdkUid":{"$ref":"#/components/schemas/nanoid"},"version":{"$ref":"#/components/schemas/version"},"languages":{"minItems":1,"type":"array","items":{"type":"string","enum":["typescript","python","cli","csharp","java","ruby","php","go","rust","kotlin","swift","cpp","dart"]}}},"required":["sdkUid"],"additionalProperties":false}}},"required":true}}},"/themes/{slug}":{"get":{"tags":["themes"],"description":"Get a theme document by slug","operationId":"getThemesSlug","responses":{"200":{"description":"Default Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"patch":{"tags":["themes"],"description":"Update themes metadata","operationId":"patchThemesSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"},"description":{"type":"string"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"put":{"tags":["themes"],"description":"Update themes document","operationId":"putThemesSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"string"}},"required":["document"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]},"delete":{"tags":["themes"],"description":"Delete a specific themes","operationId":"deleteThemesSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/themes":{"get":{"tags":["themes"],"description":"Get a list of all themes for the team","operationId":"getThemes","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"$ref":"#/components/schemas/nanoid"},"name":{"type":"string"},"description":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["uid","name","description","slug"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}},"post":{"tags":["themes"],"description":"Create a new theme for the team","operationId":"postThemes","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"}},"required":["uid","slug"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"slug":{"$ref":"#/components/schemas/slug"},"document":{"type":"string"}},"required":["name","slug"],"additionalProperties":false}}},"required":true}}},"/user/update":{"post":{"tags":["team"],"description":"Update user record","operationId":"postUserUpdate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"theme":{"type":"string"}},"additionalProperties":false}}},"required":true}}},"/share/upload/{namespace}":{"post":{"tags":["share"],"description":"Upload a document to the reserved share namespace","operationId":"postShareUploadNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"namespace":{"type":"string"},"slug":{"type":"string"}},"required":["url","namespace","slug"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"string"}},"required":["document"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas"]},"in":"path","name":"namespace","required":true},{"schema":{"type":"string","enum":["agent"]},"in":"query","name":"source","required":false}]}},"/workspaces/{namespace}":{"post":{"tags":["workspace"],"description":"Creates a new workspace","operationId":"postWorkspacesNamespace","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/workspace"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"default":[]},"title":{"default":"","type":"string","maxLength":100},"description":{"default":"","type":"string"},"isPrivate":{"default":false,"type":"boolean"},"slug":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"version":{"$ref":"#/components/schemas/version"},"loginPortal":{"$ref":"#/components/schemas/slug"},"workspaceJson":{"type":"string"},"accessGroups":{"type":"array","items":{"$ref":"#/components/schemas/slug"}}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true}]}},"/workspaces/{namespace}/{slug}":{"patch":{"tags":["workspace"],"description":"Update team workspace metadata","operationId":"patchWorkspacesNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/workspace"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"version":{"$ref":"#/components/schemas/version"},"namespace":{"$ref":"#/components/schemas/namespace"},"isPrivate":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"slug":{"$ref":"#/components/schemas/slug"},"loginPortal":{"$ref":"#/components/schemas/slug"},"accessGroups":{"type":"array","items":{"$ref":"#/components/schemas/slug"}}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true}]},"delete":{"tags":["workspace"],"description":"Delete a team workspace","operationId":"deleteWorkspacesNamespaceSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true}]}},"/workspaces/{namespace}/{slug}/version":{"post":{"tags":["workspace"],"description":"Create or update a workspace JSON version","operationId":"postWorkspacesNamespaceSlugVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/workspace-version"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"$ref":"#/components/schemas/version"},"workspaceJson":{"type":"string"},"isCurrent":{"default":true,"type":"boolean"}},"required":["version","workspaceJson","isCurrent"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true}]}},"/workspaces/{namespace}/{slug}/access/{group}":{"post":{"tags":["workspace"],"description":"Adds an access group to a workspace","operationId":"postWorkspacesNamespaceSlugAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true},{"schema":{"$ref":"#/components/schemas/slug"},"in":"path","name":"group","required":true}]},"delete":{"tags":["workspace"],"description":"Removes an access group from a workspace","operationId":"deleteWorkspacesNamespaceSlugAccessGroup","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true},{"schema":{"$ref":"#/components/schemas/slug"},"in":"path","name":"group","required":true}]}},"/workspaces/{namespace}/{slug}/available":{"get":{"tags":["workspace"],"description":"Check availability for workspace namespace and slug","operationId":"getWorkspacesNamespaceSlugAvailable","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true}]}},"/workspaces/{namespace}/{slug}/version/{version}":{"delete":{"tags":["workspace"],"description":"Delete a team workspace version","operationId":"deleteWorkspacesNamespaceSlugVersionVersion","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/namespace"},"in":"path","name":"namespace","required":true},{"schema":{"default":"randomManagedDocSlug()","$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true},{"schema":{"$ref":"#/components/schemas/version"},"in":"path","name":"version","required":true}]}},"/forgejo/git-credentials":{"get":{"description":"Get Forgejo git credentials for the authenticated user","operationId":"getForgejoGitCredentials","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"forgejoBaseUrl":{"type":"string"},"forgejoToken":{"type":"string"},"forgejoUsername":{"type":"string"}},"required":["forgejoBaseUrl","forgejoToken","forgejoUsername"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/registry-git/{asset}/{namespace}/{slug}/config":{"patch":{"tags":["registry-git"],"description":"Update git publish-trigger config for a registry resource","operationId":"patchRegistryGitAssetNamespaceSlugConfig","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/doc-source"}},"required":["source"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"publishOnPush":{"type":"boolean"},"publishOnMerge":{"type":"boolean"},"trackedBranch":{"type":"string","minLength":1}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/history":{"get":{"tags":["registry-git"],"description":"Raw git commit history for a registry resource","operationId":"getRegistryGitAssetNamespaceSlugHistory","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"commits":{"type":"array","items":{"type":"object","properties":{"sha":{"type":"string"},"message":{"type":"string"},"authorName":{"type":"string"},"authorEmail":{"type":"string"},"timestamp":{"type":"number"}},"required":["sha","message","authorName","authorEmail","timestamp"],"additionalProperties":false}}},"required":["commits"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"in":"query","name":"page","required":true},{"schema":{"default":30,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"perPage","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/publishes":{"get":{"tags":["registry-git"],"description":"Curated publish log for a registry resource","operationId":"getRegistryGitAssetNamespaceSlugPublishes","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"publishes":{"type":"array","items":{"$ref":"#/components/schemas/registry-publish"}}},"required":["publishes"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/source":{"get":{"tags":["registry-git"],"description":"The resource’s authoring source, with its linked repository resolved","operationId":"getRegistryGitAssetNamespaceSlugSource","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"anyOf":[{"$ref":"#/components/schemas/doc-source"},{"type":"null"}]},"repository":{"anyOf":[{"$ref":"#/components/schemas/linked-repository"},{"type":"null"}]},"openProposal":{"anyOf":[{"type":"object","properties":{"prNumber":{"type":"number"},"branch":{"type":"string"}},"required":["prNumber","branch"],"additionalProperties":false},{"type":"null"}]}},"required":["source","repository","openProposal"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/branches":{"get":{"tags":["registry-git"],"description":"List the linked repository’s branches","operationId":"getRegistryGitAssetNamespaceSlugBranches","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"sha":{"type":"string"}},"required":["name","sha"],"additionalProperties":false}},"trackedBranch":{"type":"string"}},"required":["branches","trackedBranch"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"in":"query","name":"page","required":true},{"schema":{"default":100,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"perPage","required":true}]},"post":{"tags":["registry-git"],"description":"Create a branch on the linked repository","operationId":"postRegistryGitAssetNamespaceSlugBranches","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"sha":{"type":"string"}},"required":["name","sha"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9._/-]{1,200}$"},"fromBranch":{"type":"string"}},"required":["name"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/file":{"get":{"tags":["registry-git"],"description":"Read the resource’s canonical file at a ref on the linked repository","operationId":"getRegistryGitAssetNamespaceSlugFile","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"sha":{"type":"string"},"ref":{"type":"string"}},"required":["content","sha","ref"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true},{"schema":{"type":"string"},"in":"query","name":"ref","required":false}]}},"/registry-git/{asset}/{namespace}/{slug}/publish":{"post":{"tags":["registry-git"],"description":"Publish a registry resource from a git commit (defaults to the branch head)","operationId":"postRegistryGitAssetNamespaceSlugPublish","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"commitSha":{"type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["commitSha","version"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"commitSha":{"type":"string","pattern":"^[0-9a-f]{7,64}$"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/provision":{"post":{"tags":["registry-git"],"description":"Set up git tracking for an existing registry resource: create its repo and seed the current content","operationId":"postRegistryGitAssetNamespaceSlugProvision","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"git":{"anyOf":[{"$ref":"#/components/schemas/registry-git-binding"},{"type":"null"}]},"status":{"type":"string","enum":["migrated","already-migrated","partial"]},"versionsImported":{"type":"number"},"versionsSkipped":{"type":"number"}},"required":["git","status","versionsImported","versionsSkipped"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/link-external":{"post":{"tags":["registry-git"],"description":"Link a GitHub repo as the source of truth for a registry resource: opens a PR adding the canonical file, then pushes and merges on the tracked branch drive publishes","operationId":"postRegistryGitAssetNamespaceSlugLinkExternal","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"$ref":"#/components/schemas/linked-repository"},"source":{"$ref":"#/components/schemas/doc-source"},"pullRequest":{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"branch":{"type":"string"}},"required":["url","number","branch"],"additionalProperties":false}},"required":["repository","source","pullRequest"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["github","bitbucket"]},"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"repoId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["provider"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/unlink-external":{"post":{"tags":["registry-git"],"description":"Disconnect the linked repository; the resource returns to platform authoring","operationId":"postRegistryGitAssetNamespaceSlugUnlinkExternal","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/doc-source"}},"required":["source"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"type":"string","enum":["apis","schemas","rules","sdks"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/registry-git/{asset}/{namespace}/{slug}/propose":{"post":{"tags":["registry-git"],"description":"Propose an edit to a git-sourced document as a pull request on the linked repo","operationId":"postRegistryGitAssetNamespaceSlugPropose","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"prNumber":{"type":"number"},"prUrl":{"type":"string"},"branch":{"type":"string"}},"required":["prNumber","prUrl","branch"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"document":{"type":"string"},"message":{"type":"string","maxLength":500},"baseSha":{"type":"string","pattern":"^[0-9a-f]{7,64}$"}},"required":["version","document"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["apis","schemas"]},"in":"path","name":"asset","required":true},{"schema":{"type":"string"},"in":"path","name":"namespace","required":true},{"schema":{"type":"string"},"in":"path","name":"slug","required":true}]}},"/docs-projects/create":{"post":{"description":"Create a unified DocsProject backed by the chosen VCS provider (forgejo, github, or bitbucket)","operationId":"postDocsProjectsCreate","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/docs-project"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"slug":{"$ref":"#/components/schemas/slug"},"isPrivate":{"default":false,"type":"boolean"},"blank":{"default":false,"type":"boolean"},"provider":{"type":"string","enum":["forgejo","github","bitbucket"]},"githubRepository":{"type":"object","properties":{"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"repoId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["installationId","repoId"],"additionalProperties":false},"bitbucketRepository":{"type":"object","properties":{"workspaceUuid":{"type":"string"},"repoUuid":{"type":"string"}},"required":["workspaceUuid","repoUuid"],"additionalProperties":false}},"required":["name","isPrivate","blank","provider"],"additionalProperties":false}}},"required":true}}},"/docs-projects/delete":{"delete":{"description":"Delete a unified DocsProject. Tears down deploys + publish records + cached builds, repoints user activeProjectUid, deletes the Forgejo repo (if any), and notifies subscribers. User-owned GitHub repos are left untouched.","operationId":"deleteDocsProjectsDelete","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"$ref":"#/components/schemas/nanoid"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/docs-projects/{slug}":{"get":{"description":"Get a unified DocsProject by slug for the current team","operationId":"getDocsProjectsSlug","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/docs-project"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/slug"},"in":"path","name":"slug","required":true}]}},"/docs-projects/update-repo-settings":{"post":{"description":"Update editable repository settings (tracked branch, config path) on a unified DocsProject. Publish flags live in scalar.config.json.","operationId":"postDocsProjectsUpdateRepoSettings","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectUid":{"$ref":"#/components/schemas/nanoid"},"branch":{"type":"string","minLength":1},"configPath":{"type":"string"}},"required":["projectUid"],"additionalProperties":false}}},"required":true}}},"/docs-projects/{projectUid}/link-github":{"post":{"description":"Convert a Forgejo-backed DocsProject into a GitHub-backed one. Reads every file from the Forgejo repo and opens a single PR on the chosen GitHub repo putting the content under scalar-docs/. A repo with no commits has nothing to collide with and nothing to review against, so it is initialised with the docs at its root on the default branch, and no pull request is returned.","operationId":"postDocsProjectsProjectUidLinkGithub","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"pullRequest":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"branch":{"type":"string"}},"required":["url","number","branch"],"additionalProperties":false},{"type":"null"}]},"project":{"$ref":"#/components/schemas/docs-project"}},"required":["pullRequest","project"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"installationId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"repoId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["installationId","repoId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true}]}},"/docs-projects/{projectUid}/unlink-github":{"post":{"description":"Convert a GitHub-backed DocsProject back to a Forgejo-backed one. Migrates the GitHub repository contents into a fresh Forgejo repo and flips the project provider.","operationId":"postDocsProjectsProjectUidUnlinkGithub","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/docs-project"}},"required":["project"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true}]}},"/docs-projects/{projectUid}/link-bitbucket":{"post":{"description":"Convert a Forgejo-backed DocsProject into a Bitbucket-backed one. Reads every file from the Forgejo repo and opens a single PR on the chosen Bitbucket repo putting the content under scalar-docs/.","operationId":"postDocsProjectsProjectUidLinkBitbucket","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"pullRequest":{"type":"object","properties":{"url":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"branch":{"type":"string"}},"required":["url","number","branch"],"additionalProperties":false},"project":{"$ref":"#/components/schemas/docs-project"}},"required":["pullRequest","project"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceUuid":{"type":"string"},"repoUuid":{"type":"string"}},"required":["workspaceUuid","repoUuid"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true}]}},"/docs-projects/{projectUid}/unlink-bitbucket":{"post":{"description":"Convert a Bitbucket-backed DocsProject back to a Forgejo-backed one. Migrates the Bitbucket repository contents into a fresh Forgejo repo and flips the project provider.","operationId":"postDocsProjectsProjectUidUnlinkBitbucket","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/docs-project"}},"required":["project"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true}]}},"/docs-projects/{projectUid}/bitbucket/refresh-webhook":{"post":{"description":"Re-register the Bitbucket webhook on a Bitbucket-backed DocsProject. Used to recover from a failed initial registration after the linker user is granted repo admin.","operationId":"postDocsProjectsProjectUidBitbucketRefreshWebhook","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/docs-project"}},"required":["project"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true}]}},"/analytics/projects/{projectUid}/overview":{"get":{"tags":["analytics"],"description":"KPI totals + timeseries + consumer breakdown for a docs project","operationId":"getAnalyticsProjectsProjectUidOverview","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"totals":{"type":"object","properties":{"views":{"type":"integer","minimum":0,"maximum":9007199254740991},"peak_daily_visitors":{"type":"integer","minimum":0,"maximum":9007199254740991},"human":{"type":"integer","minimum":0,"maximum":9007199254740991},"bot":{"type":"integer","minimum":0,"maximum":9007199254740991},"llm":{"type":"integer","minimum":0,"maximum":9007199254740991},"mcp":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["views","peak_daily_visitors","human","bot","llm","mcp"],"additionalProperties":false},"timeseries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"human":{"type":"integer","minimum":0,"maximum":9007199254740991},"bot":{"type":"integer","minimum":0,"maximum":9007199254740991},"llm":{"type":"integer","minimum":0,"maximum":9007199254740991},"unique":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["bucket","human","bot","llm","unique"],"additionalProperties":false}}},"required":["totals","timeseries"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true},{"schema":{"default":"7d","type":"string","enum":["24h","7d","30d","90d"]},"in":"query","name":"range","required":true},{"schema":{"type":"string","enum":["hour","day"]},"in":"query","name":"granularity","required":false}]}},"/analytics/projects/{projectUid}/pages":{"get":{"tags":["analytics"],"description":"Top pages by views for a docs project","operationId":"getAnalyticsProjectsProjectUidPages","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"pages":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"views":{"type":"integer","minimum":0,"maximum":9007199254740991},"unique":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["path","views","unique"],"additionalProperties":false}}},"required":["pages"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true},{"schema":{"default":"7d","type":"string","enum":["24h","7d","30d","90d"]},"in":"query","name":"range","required":true},{"schema":{"default":20,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":true}]}},"/analytics/projects/{projectUid}/referrers":{"get":{"tags":["analytics"],"description":"Top referrers for a docs project","operationId":"getAnalyticsProjectsProjectUidReferrers","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"referrers":{"type":"array","items":{"type":"object","properties":{"referrer":{"type":"string"},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["referrer","views"],"additionalProperties":false}}},"required":["referrers"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true},{"schema":{"default":"7d","type":"string","enum":["24h","7d","30d","90d"]},"in":"query","name":"range","required":true},{"schema":{"default":20,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":true}]}},"/analytics/projects/{projectUid}/consumers":{"get":{"tags":["analytics"],"description":"Consumer breakdown (human/bot/llm/mcp) for a docs project","operationId":"getAnalyticsProjectsProjectUidConsumers","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"totals":{"type":"object","properties":{"human":{"type":"integer","minimum":0,"maximum":9007199254740991},"bot":{"type":"integer","minimum":0,"maximum":9007199254740991},"llm":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["human","bot","llm"],"additionalProperties":false},"timeseries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"human":{"type":"integer","minimum":0,"maximum":9007199254740991},"bot":{"type":"integer","minimum":0,"maximum":9007199254740991},"llm":{"type":"integer","minimum":0,"maximum":9007199254740991},"unique":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["bucket","human","bot","llm","unique"],"additionalProperties":false}}},"required":["totals","timeseries"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"projectUid","required":true},{"schema":{"default":"7d","type":"string","enum":["24h","7d","30d","90d"]},"in":"query","name":"range","required":true},{"schema":{"type":"string","enum":["hour","day"]},"in":"query","name":"granularity","required":false}]}},"/v1/webhooks":{"post":{"tags":["webhooks"],"description":"Create a webhook subscription","operationId":"postV1Webhooks","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"event":{"default":"sdk.build.completed","$ref":"#/components/schemas/webhook-event"},"url":{"type":"string","format":"uri"},"enabled":{"default":true,"type":"boolean"},"description":{"default":"","type":"string","maxLength":200},"consecutiveFailures":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"disabledReason":{"anyOf":[{"$ref":"#/components/schemas/webhook-disabled-reason"},{"type":"null"}]},"disabledAt":{"anyOf":[{"type":"number"},{"type":"null"}]},"secret":{"type":"string"}},"required":["uid","createdAt","updatedAt","event","url","enabled","description","consecutiveFailures","secret"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"event":{"$ref":"#/components/schemas/webhook-event"},"description":{"default":"","type":"string","maxLength":200}},"required":["url","event","description"],"additionalProperties":false}}},"required":true}}},"/v1/webhooks/{uid}":{"patch":{"tags":["webhooks"],"description":"Update a webhook subscription","operationId":"patchV1WebhooksUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"event":{"default":"sdk.build.completed","$ref":"#/components/schemas/webhook-event"},"url":{"type":"string","format":"uri"},"enabled":{"default":true,"type":"boolean"},"description":{"default":"","type":"string","maxLength":200},"consecutiveFailures":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"disabledReason":{"anyOf":[{"$ref":"#/components/schemas/webhook-disabled-reason"},{"type":"null"}]},"disabledAt":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["uid","createdAt","updatedAt","event","url","enabled","description","consecutiveFailures"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"event":{"$ref":"#/components/schemas/webhook-event"},"description":{"type":"string","maxLength":200},"enabled":{"type":"boolean"}},"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]},"delete":{"tags":["webhooks"],"description":"Delete a webhook subscription","operationId":"deleteV1WebhooksUid","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/webhooks/{uid}/secret":{"post":{"tags":["webhooks"],"description":"Rotate the signing secret for a webhook subscription","operationId":"postV1WebhooksUidSecret","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"secret":{"type":"string"},"previousSecretExpiresAt":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["secret","previousSecretExpiresAt"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"requestBody":{"content":{"application/json":{"schema":{"default":{"revoke":false},"type":"object","properties":{"revoke":{"default":false,"type":"boolean"}},"required":["revoke"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/webhooks/delivery-counts":{"get":{"tags":["webhooks"],"description":"Count successful deliveries for each webhook subscription","operationId":"getV1WebhooksDeliveryCounts","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"subscriptionUid":{"$ref":"#/components/schemas/nanoid"},"count":{"type":"number"}},"required":["subscriptionUid","count"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}}}},"/v1/webhooks/{uid}/deliveries":{"get":{"tags":["webhooks"],"description":"List recent delivery attempts for a webhook subscription","operationId":"getV1WebhooksUidDeliveries","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"uid":{"default":"nanoid()","$ref":"#/components/schemas/nanoid"},"createdAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"updatedAt":{"default":"unixTimestamp()","$ref":"#/components/schemas/timestamp"},"subscriptionUid":{"$ref":"#/components/schemas/nanoid"},"event":{"$ref":"#/components/schemas/webhook-event"},"dedupeKey":{"type":"string"},"payload":{"type":"string"},"attempts":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"default":"pending","$ref":"#/components/schemas/webhook-delivery-status"},"lastAttemptAt":{"anyOf":[{"type":"number"},{"type":"null"}]},"responseStatus":{"anyOf":[{"type":"number"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["uid","createdAt","updatedAt","subscriptionUid","event","dedupeKey","payload","attempts","status"],"additionalProperties":false}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}},"/v1/webhooks/{uid}/test":{"post":{"tags":["webhooks"],"description":"Send a test event to a webhook subscription","operationId":"postV1WebhooksUidTest","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"scheduled":{"type":"number"}},"required":["scheduled"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/400"}}}},"401":{"description":"No auth","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/404"}}}},"422":{"description":"Invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/422"}}}},"500":{"description":"Uncaught error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/500"}}}}},"parameters":[{"schema":{"$ref":"#/components/schemas/nanoid"},"in":"path","name":"uid","required":true}]}}},"webhooks":{"sdk.build.completed":{"post":{"tags":["webhooks"],"summary":"SDK build completed","description":"Sent when every language target of an SDK build has settled. `status` is `succeeded` when all targets generated, `failed` when none did, and `partial` in between. This does not mean the SDK reached the customer's repository — git sync settles after the build.","operationId":"onSdkBuildCompleted","security":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sdk-build-completed-event"}}},"required":true},"responses":{"200":{"description":"Return any 2xx to acknowledge. Anything else is retried, and repeated failures disable the endpoint."}},"parameters":[{"in":"header","name":"scalar-event","description":"The event this delivery carries.","required":true,"schema":{"type":"string"}},{"in":"header","name":"scalar-delivery","description":"Delivery uid. Deliveries are at-least-once, so deduplicate on this.","required":true,"schema":{"type":"string"}},{"in":"header","name":"scalar-signature","description":"`t=,v1=`, signed over `.` with the subscription secret. Verify against the raw body, and reject a timestamp more than 300 seconds from your own clock in either direction. A rotation grace window sends one `v1=` pair per active secret.","required":true,"schema":{"type":"string"}}]}}}}