Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in ‘pending’ status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.
IDs of existing knowledge documents this one replaces. The new document does not inherit the replaced document's folder: pass its knowledgeFolderId to keep it there.
to_validate when the document is 18 months old or more and was not validated in the last 3 months, up_to_date otherwise. Null until processing has succeeded.
Presigned S3 POST form, present only for a file document. Valid for 15 minutes.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Semji Help Center","colors":{"primary":"#ff4d64","light":"#ff7183","dark":"#ee4e63"},"logo":{"light":"https://mintcdn.com/semji/UowWanjmMxKT8I8m/images/logo.svg?fit=max\u0026auto=format\u0026n=UowWanjmMxKT8I8m\u0026q=85\u0026s=d8cabcfb94d2eec944b06e02c2fe2368","dark":"https://mintcdn.com/semji/UowWanjmMxKT8I8m/images/logo-white.svg?fit=max\u0026auto=format\u0026n=UowWanjmMxKT8I8m\u0026q=85\u0026s=a4f3fb5d2f0bac4605f9b04803f2f777"},"favicon":"https://mintcdn.com/semji/UowWanjmMxKT8I8m/images/favicon.png?fit=max\u0026auto=format\u0026n=UowWanjmMxKT8I8m\u0026q=85\u0026s=798220ad4fcced2c8c6bfc63ff414fb6","appearance":{"default":"light"},"background":{"color":{"light":"#ffffff","dark":"#020618"}},"navbar":{"links":[{"href":"https://semji.com","label":"Website"}],"primary":{"type":"button","label":"Sign in","href":"https://app.semji.com"}},"fonts":{"heading":{"family":"Montserrat"},"body":{"family":"Rubik"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","assistant","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":false},"navigation":{"languages":[{"language":"en","default":true,"href":""},{"language":"fr","href":"fr"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"semji","hasAudioNarration":false,"actualSubdomain":"semji","customDomains":["help.semji.com"],"gitSource":{"type":"github","owner":"semji","repo":"docs","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af356a90510a428249d8fcb","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"fr","tag":"Centre d'aide","count":176},{"language":"en","tag":"Help Center","count":169},{"language":"default","tag":"Developer","count":75},{"language":"default","tag":"API Reference","count":63},{"language":"en","tag":"Work faster with AI","count":47},{"language":"fr","tag":"Travailler avec l'IA","count":45},{"language":"en","tag":"Create \u0026 publish content","count":34},{"language":"fr","tag":"Créer et publier du contenu","count":34},{"language":"en","tag":"Performance \u0026 competitors","count":27},{"language":"fr","tag":"Performances \u0026 concurrents","count":27},{"language":"en","tag":"Connect your tools","count":23},{"language":"fr","tag":"Connecter vos outils","count":23},{"language":"en","tag":"Admin \u0026 settings","count":15},{"language":"en","tag":"Competitor analysis","count":15},{"language":"en","tag":"Generate with AI","count":15},{"language":"fr","tag":"Administration","count":15},{"language":"fr","tag":"Analyse concurrentielle","count":15},{"language":"default","tag":"Knowledge Documents","count":14},{"language":"fr","tag":"Générer avec l'IA","count":13},{"language":"en","tag":"SEO recommendations","count":12},{"language":"en","tag":"Specialized SEO agents","count":12},{"language":"fr","tag":"Recommandations SEO","count":12},{"language":"fr","tag":"Agents SEO spécialisés","count":12},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Contents","count":8},{"language":"default","tag":"Keywords","count":6},{"language":"default","tag":"Pages","count":6},{"language":"default","tag":"Prompts","count":5},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Quickstart","count":4}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--semji-primary-rgb: var(--primary, 255 77 100);--semji-color-primary: rgb(var(--semji-primary-rgb));--semji-color-primary-hover: rgb(var(--primary-dark, 238 78 99));--semji-gradient-primary: linear-gradient(90deg, #ff4580, #ff4d64);--semji-color-surface-container: #f4f4f5;--semji-color-surface-container-low: #fbfbfb;--semji-icon-primary-filter: brightness(0) saturate(100%) invert(47%) sepia(78%) saturate(3138%) hue-rotate(323deg) brightness(100%) contrast(102%);--semji-icon-gray-filter: brightness(0) saturate(0%) invert(65%);--semji-menu-hover-background: rgb(75 85 99 / 0.05);--semji-menu-hover-background-dark: rgb(229 231 235 / 0.05);--hc-ink: #201c28;--hc-ink-soft: #5b5460;--hc-surface: #f7f6f7;--hc-line: #e7e5e7;--hc-shadow: 26 21 35;--hc-card-bg: #ffffff}.dark{--hc-ink: #f2f0f4;--hc-ink-soft: #b0abb8;--hc-surface: #292733;--hc-line: #3c3945;--hc-shadow: 0 0 0;--hc-card-bg: #262330}@keyframes hc-fade-up{from{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}html:not(.dark) .mdx-content :not(pre)>code{background-color:var(--semji-color-surface-container)!important;border-color:var(--semji-color-surface-container)!important}html:not(.dark) [data-component-part=\"field-info-pill\"]{background-color:var(--semji-color-surface-container)!important;border-color:var(--semji-color-surface-container)!important;--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity))!important}html:not(.dark) .code-block:has(>[data-component-part=\"code-block-header\"]),html:not(.dark) .code-group,html:not(.dark) [data-component-part=\"code-block-header\"],html:not(.dark) [data-component-part=\"code-group-tab-bar\"]{background-color:var(--semji-color-surface-container-low)!important}html:not(.dark) .mdx-content .accordion>summary:hover,html:not(.dark) .mdx-content [data-component-part=\"accordion-button\"]:hover{background-color:var(--semji-menu-hover-background)!important}.dark .mdx-content .accordion>summary:hover,.dark .mdx-content [data-component-part=\"accordion-button\"]:hover{background-color:var(--semji-menu-hover-background-dark)!important}img[src*=\"/images/icons/phosphor/\"],img[alt^=\"/images/icons/phosphor/\"]{background-color:transparent!important;filter:var(--semji-icon-primary-filter)!important}.tryit-button{background-color:var(--semji-color-primary)!important;border-color:var(--semji-color-primary)!important;color:white!important}.tryit-button:hover{background-color:var(--semji-color-primary-hover)!important;border-color:var(--semji-color-primary-hover)!important}.nav-anchor img[src*=\"/images/icons/phosphor/\"],.nav-anchor img[alt^=\"/images/icons/phosphor/\"]{filter:var(--semji-icon-gray-filter)!important}.nav-anchor:hover img[src*=\"/images/icons/phosphor/\"],.nav-anchor:hover img[alt^=\"/images/icons/phosphor/\"],.nav-anchor.text-primary img[src*=\"/images/icons/phosphor/\"],.nav-anchor.text-primary img[alt^=\"/images/icons/phosphor/\"]{filter:var(--semji-icon-primary-filter)!important}.nav-anchor:hover>div[style*=\"background\"],.nav-anchor.text-primary>div[style*=\"background\"]{background:var(--semji-menu-hover-background)!important}.dark .nav-anchor:hover>div[style*=\"background\"],.dark .nav-anchor.text-primary>div[style*=\"background\"]{background:var(--semji-menu-hover-background-dark)!important}.nav-anchor.text-primary,.dark .nav-anchor.text-primary{color:var(--hc-ink)!important}nav[aria-label=\"Pages\"] [class*=\"bg-primary\"]{background-color:var(--semji-menu-hover-background)!important;color:var(--hc-ink)!important;text-shadow:none!important;font-weight:600!important}.dark nav[aria-label=\"Pages\"] [class*=\"bg-primary\"]{background-color:var(--semji-menu-hover-background-dark)!important;color:var(--hc-ink)!important}nav[aria-label=\"Pages\"] :is(button,a):hover>div>svg[style*=\"mask-image\"],nav[aria-label=\"Pages\"] li[data-active=\"true\"]>:is(button,a)>div>svg[style*=\"mask-image\"]{background-color:var(--semji-color-primary)!important}nav[aria-label=\"Pages\"] :is(button,a)[aria-expanded=\"true\"]>div>svg:not([style*=\"mask-image\"]){color:var(--semji-color-primary)!important}nav[aria-label=\"Pages\"] .sidebar-group+.sidebar-group{margin-top:8px!important}#navbar a[href=\"https://semji.com\"],#navbar a[href=\"https://app.semji.com\"]{font-weight:600!important;color:var(--hc-ink)!important}#navbar a[href=\"https://semji.com\"]:hover,#navbar a[href=\"https://app.semji.com\"]:hover{color:var(--semji-color-primary)!important}body:has(.hc-hero) nav[aria-label=\"Pages\"],body:has(.hc-hero) .breadcrumb-list,body:has(.hc-hero) #search-bar-entry,body:has(.hc-hero) .chat-assistant-floating-input{display:none!important}body:has(.hc-hero) main{max-width:none!important;width:100%}body:has(.hc-hero) header[class*=\"page-header\"]{text-align:center;padding:28px 24px 6px}body:has(.hc-hero) header[class*=\"page-header\"] h1{width:100%;opacity:0;animation:hc-fade-up 0.5s cubic-bezier(0.16, 1, 0.3, 1) forwards}body:has(.hc-hero) header[class*=\"page-header\"] p{display:none!important}.hc-hero{position:relative;padding:6px clamp(20px, 5vw, 40px) clamp(40px, 6vw, 56px);margin-bottom:8px}.hc-hero::before{content:\"\";position:absolute;inset:-60% 15% auto 15%;height:140px;background:var(--semji-gradient-primary);filter:blur(60px);opacity:0.18;z-index:-1;pointer-events:none}.hc-hero .hc-search-shell{opacity:0;animation:hc-fade-up 0.5s cubic-bezier(0.16, 1, 0.3, 1) forwards;animation-delay:0.1s}.hc-search-shell{margin:30px auto 0;max-width:760px}.hc-search-box{display:flex;align-items:center;gap:14px;width:100%;background:var(--hc-card-bg);border:1.5px solid var(--hc-line);border-radius:18px;padding:22px 26px;cursor:pointer;box-shadow:0 10px 30px -14px rgb(var(--hc-shadow) / 0.25);transition:border-color 0.25s ease, box-shadow 0.25s ease, transform 0.25s cubic-bezier(0.16, 1, 0.3, 1);font-family:inherit;text-align:left}.hc-search-box:hover{border-color:var(--semji-color-primary);transform:translateY(-1px);box-shadow:0 14px 34px -14px rgb(var(--hc-shadow) / 0.32)}.hc-search-box:focus-visible{border-color:var(--semji-color-primary);box-shadow:0 0 0 3px rgb(var(--semji-primary-rgb) / 0.18)}.hc-search-box svg{flex:none;width:22px;height:22px;color:var(--hc-ink-soft);transition:color 0.2s ease}.hc-search-box:hover svg{color:var(--semji-color-primary)}.hc-search-box span.hc-placeholder{flex:1;color:var(--hc-ink-soft);font-size:18px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.hc-search-kbd{flex:none;font-size:11.5px;color:var(--hc-ink-soft);border:1px solid var(--hc-line);border-radius:6px;padding:2px 6px}.hc-section{margin:48px auto;max-width:960px}.hc-section-head{display:flex;align-items:baseline;justify-content:space-between;gap:16px;margin-bottom:22px}.hc-section-head h2{font-size:21px!important;margin:0!important}.hc-cat-grid{display:grid;grid-template-columns:repeat(3, 1fr);gap:14px}.hc-cat-grid .hc-cat-card:last-child:nth-child(3n+1){grid-column:2}@media (max-width: 900px){.hc-cat-grid{grid-template-columns:repeat(2, 1fr)}.hc-cat-grid .hc-cat-card:last-child:nth-child(3n+1){grid-column:auto}.hc-cat-grid .hc-cat-card:last-child:nth-child(2n+1){grid-column:1 / -1;max-width:calc(50% - 7px);margin:0 auto}}@media (max-width: 600px){.hc-cat-grid{grid-template-columns:1fr}.hc-cat-grid .hc-cat-card:last-child{grid-column:auto;max-width:none;margin:0}}.hc-cat-card{display:block;position:relative;overflow:hidden;text-decoration:none!important;color:inherit;background:var(--hc-card-bg);border:1px solid var(--hc-line);border-radius:14px;padding:18px 20px;transition:transform 0.25s cubic-bezier(0.16, 1, 0.3, 1), border-color 0.25s ease, box-shadow 0.25s cubic-bezier(0.16, 1, 0.3, 1);opacity:0;animation:hc-fade-up 0.5s cubic-bezier(0.16, 1, 0.3, 1) forwards}.hc-cat-grid .hc-cat-card:nth-child(1){animation-delay:0.03s}.hc-cat-grid .hc-cat-card:nth-child(2){animation-delay:0.08s}.hc-cat-grid .hc-cat-card:nth-child(3){animation-delay:0.13s}.hc-cat-grid .hc-cat-card:nth-child(4){animation-delay:0.18s}.hc-cat-grid .hc-cat-card:nth-child(5){animation-delay:0.23s}.hc-cat-grid .hc-cat-card:nth-child(6){animation-delay:0.28s}.hc-cat-grid .hc-cat-card:nth-child(7){animation-delay:0.33s}.hc-cat-grid .hc-cat-card:nth-child(8){animation-delay:0.38s}.hc-cat-grid .hc-cat-card:nth-child(9){animation-delay:0.43s}.hc-cat-card:hover{transform:translateY(-3px) scale(1.03);border-color:var(--semji-color-primary);box-shadow:0 16px 32px -16px rgb(var(--hc-shadow) / 0.35), 0 0 0 1px rgb(var(--semji-primary-rgb) / 0.12)}.hc-cat-card::after,.hc-new-card::after{content:\"\";position:absolute;inset:0;left:-60%;width:45%;background:linear-gradient(115deg, transparent, rgb(255 255 255 / 0.35), transparent);transform:skewX(-18deg) translateX(0);pointer-events:none;transition:transform 0.65s cubic-bezier(0.16, 1, 0.3, 1)}.dark .hc-cat-card::after,.dark .hc-new-card::after{background:linear-gradient(115deg, transparent, rgb(255 255 255 / 0.08), transparent)}.hc-cat-card:hover::after,.hc-new-card:hover::after{transform:skewX(-18deg) translateX(340%)}.hc-cat-icon{width:36px;height:36px;display:flex;align-items:center;justify-content:center;margin-bottom:12px;transition:transform 0.35s cubic-bezier(0.34, 1.56, 0.64, 1)}.hc-cat-card:hover .hc-cat-icon{transform:scale(1.1) rotate(-6deg)}.hc-cat-icon img{width:24px;height:24px}.hc-card-title{display:block;font-family:'Montserrat', var(--font-heading, sans-serif);color:var(--hc-ink)!important}.hc-cat-card .hc-card-title{font-size:15px;font-weight:600!important;margin:0 0 4px}.hc-cat-card p:not(.hc-card-title){font-size:13.5px;font-weight:400!important;color:var(--hc-ink-soft);margin:0 0 10px;line-height:1.5}.hc-new-grid{display:grid;grid-template-columns:repeat(2, 1fr);gap:14px}@media (max-width: 600px){.hc-new-grid{grid-template-columns:1fr}}.hc-new-card{position:relative;overflow:hidden;border:1px solid var(--hc-line);border-radius:14px;padding:18px;background:var(--hc-card-bg);transition:transform 0.25s cubic-bezier(0.16, 1, 0.3, 1), border-color 0.25s ease, box-shadow 0.25s cubic-bezier(0.16, 1, 0.3, 1);opacity:0;animation:hc-fade-up 0.5s cubic-bezier(0.16, 1, 0.3, 1) forwards}.hc-new-grid .hc-new-card:nth-child(1){animation-delay:0.05s}.hc-new-grid .hc-new-card:nth-child(2){animation-delay:0.1s}.hc-new-grid .hc-new-card:nth-child(3){animation-delay:0.15s}.hc-new-grid .hc-new-card:nth-child(4){animation-delay:0.2s}.hc-new-card:hover{transform:translateY(-3px) scale(1.03);border-color:var(--semji-color-primary);box-shadow:0 16px 32px -16px rgb(var(--hc-shadow) / 0.3)}.hc-new-card .hc-card-title{font-size:14.5px;font-weight:600!important;margin:0 0 6px}.hc-new-card p:not(.hc-card-title){font-size:13px;font-weight:400!important;color:var(--hc-ink-soft);margin:0}.hc-contact{display:flex;flex-wrap:wrap;gap:18px;justify-content:space-between;align-items:center;background:var(--hc-surface);border:1px solid var(--hc-line);border-radius:16px;padding:20px 26px}.hc-contact p{margin:0!important;font-size:14.5px;font-weight:600}.hc-contact-links{display:flex;flex-wrap:wrap;gap:10px 22px}.hc-contact-links a{display:inline-flex;align-items:center;gap:6px;font-size:13.5px;font-weight:500;color:var(--hc-ink-soft)!important;text-decoration:none!important}.hc-contact-links a:hover{color:var(--semji-color-primary)!important}html[data-current-path=\"/developers/overview\"] .card-group .card{opacity:0;animation:hc-fade-up 0.5s cubic-bezier(0.16, 1, 0.3, 1) forwards}html[data-current-path=\"/developers/overview\"] .card-group:nth-of-type(1) .card:nth-child(1){animation-delay:0.03s}html[data-current-path=\"/developers/overview\"] .card-group:nth-of-type(1) .card:nth-child(2){animation-delay:0.08s}html[data-current-path=\"/developers/overview\"] .card-group:nth-of-type(2) .card:nth-child(1){animation-delay:0.13s}html[data-current-path=\"/developers/overview\"] .card-group:nth-of-type(2) .card:nth-child(2){animation-delay:0.18s}html[data-current-path=\"/developers/overview\"] .card-group:nth-of-type(2) .card:nth-child(3){animation-delay:0.23s}html[data-current-path=\"/en/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"],html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]{opacity:0;animation:hc-fade-up 0.4s cubic-bezier(0.16, 1, 0.3, 1) forwards}html[data-current-path=\"/en/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(1),html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(1){animation-delay:0.03s}html[data-current-path=\"/en/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(2),html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(2){animation-delay:0.07s}html[data-current-path=\"/en/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(3),html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(3){animation-delay:0.11s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(4){animation-delay:0.15s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(5){animation-delay:0.19s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(6){animation-delay:0.23s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(7){animation-delay:0.27s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(8){animation-delay:0.31s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(9){animation-delay:0.35s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(10){animation-delay:0.39s}html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]:nth-of-type(11){animation-delay:0.43s}html[data-current-path$=\"/overview\"] .mdx-content a.link{font-weight:400!important}html[data-current-path=\"/en/getting-started/first-steps\"] .mdx-content a.link,html[data-current-path=\"/en/getting-started/connect-your-data\"] .mdx-content a.link,html[data-current-path=\"/en/getting-started/users-and-permissions\"] .mdx-content a.link,html[data-current-path=\"/en/getting-started/create-your-first-content\"] .mdx-content a.link,html[data-current-path=\"/fr/getting-started/first-steps\"] .mdx-content a.link,html[data-current-path=\"/fr/getting-started/connect-your-data\"] .mdx-content a.link,html[data-current-path=\"/fr/getting-started/users-and-permissions\"] .mdx-content a.link,html[data-current-path=\"/fr/getting-started/create-your-first-content\"] .mdx-content a.link{font-weight:400!important}html[data-current-path=\"/en/admin-and-settings/billing-and-organization\"] .mdx-content a.link,html[data-current-path=\"/en/admin-and-settings/languages-and-general-preferences\"] .mdx-content a.link,html[data-current-path=\"/en/admin-and-settings/security-and-privacy\"] .mdx-content a.link,html[data-current-path=\"/en/admin-and-settings/users-and-roles\"] .mdx-content a.link,html[data-current-path=\"/en/ai-agents/advanced-use-cases\"] .mdx-content a.link,html[data-current-path=\"/en/ai-agents/agent-basics\"] .mdx-content a.link,html[data-current-path=\"/en/ai-agents/pre-configured-agents\"] .mdx-content a.link,html[data-current-path=\"/en/ai-agents/proactive-agents\"] .mdx-content a.link,html[data-current-path=\"/en/analyze-competitors/competitor-analysis\"] .mdx-content a.link,html[data-current-path=\"/en/analyze-performance/managing-your-seo-performance\"] .mdx-content a.link,html[data-current-path=\"/en/analyze-performance/understanding-performance-metrics\"] .mdx-content a.link,html[data-current-path=\"/en/connect-your-tools/cms-and-publishing\"] .mdx-content a.link,html[data-current-path=\"/en/connect-your-tools/connect-analytics-and-gsc\"] .mdx-content a.link,html[data-current-path=\"/en/connect-your-tools/extension-and-api\"] .mdx-content a.link,html[data-current-path=\"/en/create-optimize-and-publish/optimize-for-geo\"] .mdx-content a.link,html[data-current-path=\"/en/create-optimize-and-publish/optimize-for-seo\"] .mdx-content a.link,html[data-current-path=\"/en/create-optimize-and-publish/prepare-and-write\"] .mdx-content a.link,html[data-current-path=\"/en/create-optimize-and-publish/update-and-publish\"] .mdx-content a.link,html[data-current-path=\"/en/identify-opportunities/content-gaps-and-prioritization\"] .mdx-content a.link,html[data-current-path=\"/en/identify-opportunities/exploring-your-pages-in-semji\"] .mdx-content a.link,html[data-current-path=\"/en/identify-opportunities/identify-opportunities\"] .mdx-content a.link,html[data-current-path=\"/en/plan-your-content/adapting-the-planning-to-your-production-workflow\"] .mdx-content a.link,html[data-current-path=\"/en/plan-your-content/understanding-the-planning-view\"] .mdx-content a.link,html[data-current-path=\"/en/resources-and-webinars/general\"] .mdx-content a.link,html[data-current-path=\"/en/troubleshooting-and-support/access-and-connection-issues\"] .mdx-content a.link,html[data-current-path=\"/en/troubleshooting-and-support/frequently-asked-questions\"] .mdx-content a.link,html[data-current-path=\"/en/troubleshooting-and-support/general\"] .mdx-content a.link,html[data-current-path=\"/en/work-faster-with-ai/general\"] .mdx-content a.link,html[data-current-path=\"/en/work-faster-with-ai/generate-content-with-ai\"] .mdx-content a.link,html[data-current-path=\"/fr/admin-and-settings/billing-and-organization\"] .mdx-content a.link,html[data-current-path=\"/fr/admin-and-settings/languages-and-general-preferences\"] .mdx-content a.link,html[data-current-path=\"/fr/admin-and-settings/security-and-privacy\"] .mdx-content a.link,html[data-current-path=\"/fr/admin-and-settings/users-and-roles\"] .mdx-content a.link,html[data-current-path=\"/fr/ai-agents/advanced-use-cases\"] .mdx-content a.link,html[data-current-path=\"/fr/ai-agents/agent-basics\"] .mdx-content a.link,html[data-current-path=\"/fr/ai-agents/pre-configured-agents\"] .mdx-content a.link,html[data-current-path=\"/fr/ai-agents/proactive-agents\"] .mdx-content a.link,html[data-current-path=\"/fr/analyze-competitors/competitor-analysis\"] .mdx-content a.link,html[data-current-path=\"/fr/analyze-performance/managing-your-seo-performance\"] .mdx-content a.link,html[data-current-path=\"/fr/analyze-performance/understanding-performance-metrics\"] .mdx-content a.link,html[data-current-path=\"/fr/connect-your-tools/cms-and-publishing\"] .mdx-content a.link,html[data-current-path=\"/fr/connect-your-tools/connect-analytics-and-gsc\"] .mdx-content a.link,html[data-current-path=\"/fr/connect-your-tools/extension-and-api\"] .mdx-content a.link,html[data-current-path=\"/fr/create-optimize-and-publish/optimize-for-geo\"] .mdx-content a.link,html[data-current-path=\"/fr/create-optimize-and-publish/optimize-for-seo\"] .mdx-content a.link,html[data-current-path=\"/fr/create-optimize-and-publish/prepare-and-write\"] .mdx-content a.link,html[data-current-path=\"/fr/create-optimize-and-publish/update-and-publish\"] .mdx-content a.link,html[data-current-path=\"/fr/identify-opportunities/content-gaps-and-prioritization\"] .mdx-content a.link,html[data-current-path=\"/fr/identify-opportunities/exploring-your-pages-in-semji\"] .mdx-content a.link,html[data-current-path=\"/fr/identify-opportunities/identify-opportunities\"] .mdx-content a.link,html[data-current-path=\"/fr/plan-your-content/adapting-the-planning-to-your-production-workflow\"] .mdx-content a.link,html[data-current-path=\"/fr/plan-your-content/understanding-the-planning-view\"] .mdx-content a.link,html[data-current-path=\"/fr/resources-and-webinars/general\"] .mdx-content a.link,html[data-current-path=\"/fr/troubleshooting-and-support/access-and-connection-issues\"] .mdx-content a.link,html[data-current-path=\"/fr/troubleshooting-and-support/frequently-asked-questions\"] .mdx-content a.link,html[data-current-path=\"/fr/troubleshooting-and-support/general\"] .mdx-content a.link,html[data-current-path=\"/fr/work-faster-with-ai/general\"] .mdx-content a.link,html[data-current-path=\"/fr/work-faster-with-ai/generate-content-with-ai\"] .mdx-content a.link{font-weight:400!important}.mcpb{--mcpb-border: #e3e3e3;--mcpb-surface: #ffffff;--mcpb-chip: #f0f0f0;--mcpb-hover: #f5f5f5;--mcpb-accent: #1a1a1a;--mcpb-accent-fg: #ffffff;--mcpb-off: #d1d1d1;--mcpb-on: var(--semji-color-primary);border:1px solid var(--mcpb-border);border-radius:12px}.dark .mcpb{--mcpb-border: #3a3d50;--mcpb-surface: #2a2c3b;--mcpb-chip: #3a3d50;--mcpb-hover: #33354a;--mcpb-accent: #ffffff;--mcpb-accent-fg: #252736;--mcpb-off: #4a4d63}.mcpb input[type=\"checkbox\"]{accent-color:var(--semji-color-primary)}.mcpb-label{font-size:12px;font-weight:600;opacity:0.55;text-transform:uppercase;letter-spacing:0.5px;margin-bottom:10px}.mcpb-row{display:flex;flex-wrap:wrap;gap:24px;align-items:flex-start;padding:16px 20px}.mcpb-block{padding:16px 20px;border-top:1px solid var(--mcpb-border)}.mcpb-toolsets{flex:1 1 280px;position:relative}.mcpb-toggle{width:42px;height:24px;border-radius:999px;border:none;padding:3px;cursor:pointer;background:var(--mcpb-off);transition:background 0.15s;display:inline-flex;align-items:center}.mcpb-toggle[aria-checked=\"true\"]{background:var(--mcpb-on)}.mcpb-knob{width:18px;height:18px;border-radius:50%;background:#fff;transition:transform 0.15s}.mcpb-toggle[aria-checked=\"true\"] .mcpb-knob{transform:translateX(18px)}.mcpb-control{width:100%;min-height:42px;display:flex;align-items:center;gap:8px;padding:6px 10px;border:1px solid var(--mcpb-border);border-radius:8px;background:var(--mcpb-surface);color:inherit;cursor:pointer;text-align:left}.mcpb-chips{display:flex;flex-wrap:wrap;gap:6px;flex:1}.mcpb-chip{display:inline-flex;align-items:center;gap:6px;padding:2px 8px;border-radius:6px;background:var(--mcpb-chip);font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:0.3px}.mcpb-chip-x{cursor:pointer;opacity:0.6}.mcpb-placeholder{opacity:0.55;font-size:14px}.mcpb-caret{flex-shrink:0;opacity:0.5}.mcpb-pop{position:absolute;top:calc(100% + 6px);left:0;right:0;z-index:20;max-height:260px;overflow-y:auto;border:1px solid var(--mcpb-border);border-radius:8px;background:var(--mcpb-surface);box-shadow:0 8px 24px rgb(0 0 0 / 0.18)}.mcpb-opt{display:block;padding:10px 12px;cursor:pointer}.mcpb-opt:hover,.mcpb-opt[data-selected=\"true\"]{background:var(--mcpb-hover)}.mcpb-opt-title{display:flex;align-items:center;gap:10px;font-size:14px}.mcpb-opt-desc{display:block;opacity:0.7;font-size:13px;margin-left:26px;margin-top:2px}.mcpb-backdrop{position:fixed;inset:0;z-index:10}.mcpb-urlrow{display:flex;gap:8px}.mcpb-input{flex:1;font-family:monospace;font-size:13px;padding:10px 12px;border:1px solid var(--mcpb-border);border-radius:8px;background:var(--mcpb-surface);color:inherit}.mcpb-copy{padding:10px 16px;border-radius:8px;border:none;background:var(--mcpb-accent);color:var(--mcpb-accent-fg);cursor:pointer}.mcpb-note{margin-top:10px;font-size:13px;opacity:0.7}@media (prefers-reduced-motion: reduce){body:has(.hc-hero) header[class*=\"page-header\"] h1,.hc-hero .hc-search-shell,.hc-cat-card,.hc-new-card,html[data-current-path=\"/developers/overview\"] .card-group .card,html[data-current-path=\"/en/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"],html[data-current-path=\"/fr/resources-and-webinars/overview\"] .mdx-content span[data-as=\"p\"]{animation:none!important;opacity:1!important}.hc-cat-card,.hc-cat-icon,.hc-new-card,.hc-search-box{transition:none!important}.hc-cat-card:hover,.hc-new-card:hover,.hc-search-box:hover,.hc-cat-card:hover .hc-cat-icon{transform:none!important}.hc-cat-card::after,.hc-new-card::after{display:none!important}}:root{--hc-ink: #020618;--hc-ink-soft: #62748e;--hc-surface: #f8fafc;--hc-line: #e2e8f0;--hc-card-bg: #ffffff;--hc-shadow: 2 6 24;--semji-menu-hover-background: #f1f5f9;--semji-menu-hover-background-dark: rgb(255 255 255 / 0.06)}.dark{--hc-ink: #f8fafc;--hc-ink-soft: #90a1b9;--hc-surface: #0f172b;--hc-line: rgb(255 255 255 / 0.1);--hc-card-bg: #0f172b;--hc-shadow: 0 0 0}.hc-hero::before{inset:-30% 32% auto 32%;height:110px;opacity:0.05}.dark .hc-hero::before{opacity:0.09}.hc-search-box{box-shadow:0 8px 24px -12px rgb(var(--hc-shadow) / 0.2), 0 0 26px -6px rgb(var(--semji-primary-rgb) / 0.28)}.hc-search-box:hover{box-shadow:0 10px 28px -12px rgb(var(--hc-shadow) / 0.26), 0 0 30px -4px rgb(var(--semji-primary-rgb) / 0.36)}.dark .hc-search-box{box-shadow:0 0 30px -8px rgb(var(--semji-primary-rgb) / 0.32)}.dark .hc-search-box:hover{box-shadow:0 0 34px -6px rgb(var(--semji-primary-rgb) / 0.42)}.dark .hc-cat-card:hover,.dark .hc-new-card:hover{box-shadow:0 16px 32px -16px rgb(0 0 0 / 0.6), 0 0 0 1px rgb(var(--semji-primary-rgb) / 0.25)}.dark .hc-cat-card,.dark .hc-new-card{border-bottom-color:var(--hc-line)!important}.dark .hc-cat-card:hover,.dark .hc-new-card:hover{border-bottom-color:rgb(var(--semji-primary-rgb) / 0.6)!important}.dark .mdx-content :not(pre)>code{background-color:#0f172b!important;border-color:#1d293d!important}.dark nav[aria-label=\"Pages\"] [class*=\"bg-primary\"]{background-color:#0f172b!important}.dark .hc-search-kbd{border-color:#1d293d}"}],"page":{"pagePath":"api-reference/knowledge-documents/create-a-page-knowledge-document","slug":"/api-reference/knowledge-documents/create-a-page-knowledge-document","pageMetadata":{"title":"Create a page knowledge document","description":"Creates a knowledge document from exactly one source: text (`content`), a web page (`url`) or a file (`fileName` and `size` in bytes). The document starts in 'pending' status while it is processed. For a file, the response also carries `upload`, a presigned S3 POST form valid for 15 minutes: send a multipart POST to `upload.url` with every `upload.fields` entry first, then the file as the `file` field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-page-knowledge-document","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates a knowledge document from exactly one source: text (\", _jsx(_components.code, {\n children: \"content\"\n }), \"), a web page (\", _jsx(_components.code, {\n children: \"url\"\n }), \") or a file (\", _jsx(_components.code, {\n children: \"fileName\"\n }), \" and \", _jsx(_components.code, {\n children: \"size\"\n }), \" in bytes). The document starts in ‘pending’ status while it is processed. For a file, the response also carries \", _jsx(_components.code, {\n children: \"upload\"\n }), \", a presigned S3 POST form valid for 15 minutes: send a multipart POST to \", _jsx(_components.code, {\n children: \"upload.url\"\n }), \" with every \", _jsx(_components.code, {\n children: \"upload.fields\"\n }), \" entry first, then the file as the \", _jsx(_components.code, {\n children: \"file\"\n }), \" field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a page knowledge document","description":"Creates a knowledge document from exactly one source: text (`content`), a web page (`url`) or a file (`fileName` and `size` in bytes). The document starts in 'pending' status while it is processed. For a file, the response also carries `upload`, a presigned S3 POST form valid for 15 minutes: send a multipart POST to `upload.url` with every `upload.fields` entry first, then the file as the `file` field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-page-knowledge-document","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a page knowledge document","tags":["Knowledge Documents"],"description":"Creates a knowledge document from exactly one source: text (`content`), a web page (`url`) or a file (`fileName` and `size` in bytes). The document starts in 'pending' status while it is processed. For a file, the response also carries `upload`, a presigned S3 POST form valid for 15 minutes: send a multipart POST to `upload.url` with every `upload.fields` entry first, then the file as the `file` field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.","requestBody":"41890a5b-6b8a-4cf6-b9b6-8e7cbf11c4ac","parameters":["5e0875fd-d938-4f3e-b73b-797c6d22fe36"],"responses":{"201":"9a3732d7-79dc-43bc-9d8b-e9b4a15625a3"},"method":"post","type":"path","servers":[],"security":["881f5ee2-97c0-4b22-a0d3-3510f523597d"],"path":"/v1/pages/{pageId}/knowledge-documents","baseUrlOptions":[],"title":"Create a page knowledge document","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5e0875fd-d938-4f3e-b73b-797c6d22fe36":{"schema":{"type":"string","isRequired":true,"description":"Page ID.","uniqueKey":"","typeLabel":"string"},"in":"path","name":"pageId","required":true,"description":"Page ID."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Display name of the document.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"content":{"description":"Text of the document. Provide exactly one of content, url, or fileName with size.","type":"string","minLength":1,"uniqueKey":"content","typeLabel":"string"},"fileName":{"description":"Original file name, extension included. Give it with size to create a file document.","type":"string","minLength":1,"maxLength":255,"uniqueKey":"fileName","typeLabel":"string"},"replaces":{"description":"IDs of existing knowledge documents this one replaces. The new document does not inherit the replaced document's folder: pass its knowledgeFolderId to keep it there.","maxItems":500,"type":"array","items":{"type":"string","uniqueKey":"replaces.items.[INDEX]","typeLabel":"string"},"uniqueKey":"replaces","typeLabel":"string[]"},"size":{"description":"File size in bytes, up to 50 MB. Give it with fileName.","type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"size","typeLabel":"integer"},"url":{"description":"Web page to index. Provide exactly one of content, url, or fileName with size.","type":"string","format":"uri","uniqueKey":"url","typeLabel":"string\u003curi>"}},"required":["name"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","content":"\u003cstring>","fileName":"\u003cstring>","replaces":["\u003cstring>"],"size":1,"url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9a3732d7-79dc-43bc-9d8b-e9b4a15625a3":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"oneOf":[{"description":"MIME type of the uploaded file. Null when the document has no file.","type":"string","isRequired":true,"uniqueKey":"contentType.oneOf.0","typeLabel":"string"},{"description":"MIME type of the uploaded file. Null when the document has no file.","type":"null","isRequired":true,"uniqueKey":"contentType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"contentType","typeLabel":"string | null"},"createdAt":{"type":"string","description":"ISO 8601 creation date.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"createdById":{"oneOf":[{"description":"ID of the user who created the document.","type":"string","isRequired":true,"uniqueKey":"createdById.oneOf.0","typeLabel":"string"},{"description":"ID of the user who created the document.","type":"null","isRequired":true,"uniqueKey":"createdById.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"createdById","typeLabel":"string | null"},"failureReason":{"oneOf":[{"description":"Why processing failed. Null unless the status is failed.","type":"string","enum":["upload_expired","unsupported_type","encrypted","page_too_large","too_large","optimization_timeout","processing_error","kb_failed"],"isRequired":true,"uniqueKey":"failureReason.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Why processing failed. Null unless the status is failed.","type":"null","enum":["upload_expired","unsupported_type","encrypted","page_too_large","too_large","optimization_timeout","processing_error","kb_failed"],"isRequired":true,"uniqueKey":"failureReason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"failureReason","typeLabel":"enum\u003cstring> | null"},"fileName":{"oneOf":[{"description":"Original file name. Null when the document has no file.","type":"string","isRequired":true,"uniqueKey":"fileName.oneOf.0","typeLabel":"string"},{"description":"Original file name. Null when the document has no file.","type":"null","isRequired":true,"uniqueKey":"fileName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fileName","typeLabel":"string | null"},"fileSize":{"oneOf":[{"description":"File size in bytes. Null when the document has no file.","type":"integer","isRequired":true,"uniqueKey":"fileSize.oneOf.0","typeLabel":"integer"},{"description":"File size in bytes. Null when the document has no file.","type":"null","isRequired":true,"uniqueKey":"fileSize.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fileSize","typeLabel":"integer | null"},"id":{"type":"string","description":"Unique identifier of the knowledge document.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"knowledgeFolderId":{"oneOf":[{"description":"Knowledge folder holding the document. Null for the General folder and for page documents.","type":"string","isRequired":true,"uniqueKey":"knowledgeFolderId.oneOf.0","typeLabel":"string"},{"description":"Knowledge folder holding the document. Null for the General folder and for page documents.","type":"null","isRequired":true,"uniqueKey":"knowledgeFolderId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"knowledgeFolderId","typeLabel":"string | null"},"name":{"type":"string","description":"Name of the document.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"nbCitations":{"oneOf":[{"description":"Number of times AI content cited this document. Null for a document created before citations were counted and never cited since.","type":"integer","isRequired":true,"uniqueKey":"nbCitations.oneOf.0","typeLabel":"integer"},{"description":"Number of times AI content cited this document. Null for a document created before citations were counted and never cited since.","type":"null","isRequired":true,"uniqueKey":"nbCitations.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nbCitations","typeLabel":"integer | null"},"pageId":{"oneOf":[{"description":"Page the document is attached to. Null for workspace documents.","type":"string","isRequired":true,"uniqueKey":"pageId.oneOf.0","typeLabel":"string"},{"description":"Page the document is attached to. Null for workspace documents.","type":"null","isRequired":true,"uniqueKey":"pageId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"pageId","typeLabel":"string | null"},"reviewStatus":{"oneOf":[{"description":"to_validate when the document is 18 months old or more and was not validated in the last 3 months, up_to_date otherwise. Null until processing has succeeded.","type":"string","enum":["to_validate","up_to_date"],"isRequired":true,"uniqueKey":"reviewStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"to_validate when the document is 18 months old or more and was not validated in the last 3 months, up_to_date otherwise. Null until processing has succeeded.","type":"null","enum":["to_validate","up_to_date"],"isRequired":true,"uniqueKey":"reviewStatus.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reviewStatus","typeLabel":"enum\u003cstring> | null"},"status":{"oneOf":[{"description":"Processing status.","type":"string","enum":["pending","success","failed"],"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Processing status.","type":"null","enum":["pending","success","failed"],"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"summary":{"oneOf":[{"description":"Summary of the document content.","type":"string","isRequired":true,"uniqueKey":"summary.oneOf.0","typeLabel":"string"},{"description":"Summary of the document content.","type":"null","isRequired":true,"uniqueKey":"summary.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"summary","typeLabel":"string | null"},"type":{"oneOf":[{"description":"Document type.","type":"string","enum":["text","url","file"],"isRequired":true,"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Document type.","type":"null","enum":["text","url","file"],"isRequired":true,"uniqueKey":"type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"updatedAt":{"oneOf":[{"description":"ISO 8601 date of the last update.","type":"string","isRequired":true,"uniqueKey":"updatedAt.oneOf.0","typeLabel":"string"},{"description":"ISO 8601 date of the last update.","type":"null","isRequired":true,"uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string | null"},"updatedById":{"oneOf":[{"description":"ID of the user who last updated the document.","type":"string","isRequired":true,"uniqueKey":"updatedById.oneOf.0","typeLabel":"string"},{"description":"ID of the user who last updated the document.","type":"null","isRequired":true,"uniqueKey":"updatedById.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"updatedById","typeLabel":"string | null"},"url":{"oneOf":[{"description":"Source URL of a url document. Known on the single-document routes only, null elsewhere.","type":"string","isRequired":true,"uniqueKey":"url.oneOf.0","typeLabel":"string"},{"description":"Source URL of a url document. Known on the single-document routes only, null elsewhere.","type":"null","isRequired":true,"uniqueKey":"url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"url","typeLabel":"string | null"},"validatedAt":{"oneOf":[{"description":"ISO 8601 date of the last validation.","type":"string","isRequired":true,"uniqueKey":"validatedAt.oneOf.0","typeLabel":"string"},{"description":"ISO 8601 date of the last validation.","type":"null","isRequired":true,"uniqueKey":"validatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"validatedAt","typeLabel":"string | null"},"validatedById":{"oneOf":[{"description":"ID of the user who last validated the document.","type":"string","isRequired":true,"uniqueKey":"validatedById.oneOf.0","typeLabel":"string"},{"description":"ID of the user who last validated the document.","type":"null","isRequired":true,"uniqueKey":"validatedById.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"validatedById","typeLabel":"string | null"},"workspace":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"workspace.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"workspace.name","typeLabel":"string"},"websiteUrl":{"type":"string","isRequired":true,"uniqueKey":"workspace.websiteUrl","typeLabel":"string"}},"required":["id","name","websiteUrl"],"additionalProperties":false,"description":"Workspace this knowledge document belongs to.","isRequired":true,"uniqueKey":"workspace","typeLabel":"object"},"upload":{"description":"Presigned S3 POST form, present only for a file document. Valid for 15 minutes.","type":"object","properties":{"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"upload.fields.additionalProperties","typeLabel":"string"},"description":"Form fields to send first, in this order, before the file.","isRequired":true,"uniqueKey":"upload.fields","typeLabel":"object"},"url":{"type":"string","description":"URL to POST the multipart form to.","isRequired":true,"uniqueKey":"upload.url","typeLabel":"string"}},"required":["fields","url"],"additionalProperties":false,"uniqueKey":"upload","typeLabel":"object"}},"required":["contentType","createdAt","createdById","failureReason","fileName","fileSize","id","knowledgeFolderId","name","nbCitations","pageId","reviewStatus","status","summary","type","updatedAt","updatedById","url","validatedAt","validatedById","workspace"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"contentType":"\u003cstring>","createdAt":"\u003cstring>","createdById":"\u003cstring>","failureReason":"upload_expired","fileName":"\u003cstring>","fileSize":123,"id":"\u003cstring>","knowledgeFolderId":"\u003cstring>","name":"\u003cstring>","nbCitations":123,"pageId":"\u003cstring>","reviewStatus":"to_validate","status":"pending","summary":"\u003cstring>","type":"text","updatedAt":"\u003cstring>","updatedById":"\u003cstring>","url":"\u003cstring>","validatedAt":"\u003cstring>","validatedById":"\u003cstring>","workspace":{"id":"\u003cstring>","name":"\u003cstring>","websiteUrl":"\u003cstring>"},"upload":{"fields":{},"url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"881f5ee2-97c0-4b22-a0d3-3510f523597d":{"apiKey":{"bearerFormat":"API Key","description":"API key starting with `sk_`. Generate one in **Settings > API Keys**.","scheme":"bearer","type":"http","scopes":[],"schemeName":"apiKey"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"API Key","description":"API key starting with `sk_`. Generate one in **Settings > API Keys**.","scheme":"bearer","type":"http","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key starting with `sk_`. Generate one in **Settings > API Keys**.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"semji","siteName":"Semji Help Center","title":"Create a page knowledge document - Semji Help Center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/knowledge-documents/create-a-page-knowledge-document","matchLevel":0},"fr":{"href":"/api-reference/knowledge-documents/create-a-page-knowledge-document","matchLevel":0}}},"lastModified":"2026-11-10T17:38:57.619Z","originalFileLocation":"api-reference/knowledge-documents/create-a-page-knowledge-document.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in \u0026#x27;pending\u0026#x27; status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Semji Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a page knowledge document - Semji Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in \u0026#x27;pending\u0026#x27; status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Semji Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://semji.mintlify.site/_mintlify/api/og/v2?division=Knowledge+Documents\u0026amp;title=Create+a+page+knowledge+document\u0026amp;description=Creates+a+knowledge+document+from+exactly+one+source%3A+text+%28%60content%60%29%2C+a+web+page+%28%60url%60%29+or+a+file+%28%60fileName%60+and+%60size%60+in+bytes%29.+The+document+starts+in+%27p\u0026amp;theme=c36dd5df46146821b8002ea4\u0026amp;signature=dd924d217a3a5bf8ef05f6831bff7bd7080381e8977929a2d91710537ef5a012\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a page knowledge document - Semji Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in \u0026#x27;pending\u0026#x27; status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://semji.mintlify.site/_mintlify/api/og/v2?division=Knowledge+Documents\u0026amp;title=Create+a+page+knowledge+document\u0026amp;description=Creates+a+knowledge+document+from+exactly+one+source%3A+text+%28%60content%60%29%2C+a+web+page+%28%60url%60%29+or+a+file+%28%60fileName%60+and+%60size%60+in+bytes%29.+The+document+starts+in+%27p\u0026amp;theme=c36dd5df46146821b8002ea4\u0026amp;signature=dd924d217a3a5bf8ef05f6831bff7bd7080381e8977929a2d91710537ef5a012\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/semji/wqrWulQL2ghDTTXD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Semji Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff4d64\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/knowledge-documents/create-a-page-knowledge-document.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.semji.com/#organization\",\"name\":\"Semji Help Center\",\"url\":\"https://help.semji.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/semji/UowWanjmMxKT8I8m/images/logo.svg?fit=max\u0026auto=format\u0026n=UowWanjmMxKT8I8m\u0026q=85\u0026s=d8cabcfb94d2eec944b06e02c2fe2368\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.semji.com#website\",\"name\":\"Semji Help Center\",\"url\":\"https://help.semji.com\",\"publisher\":{\"@id\":\"https://help.semji.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document#webpage\",\"url\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document\",\"name\":\"Create a page knowledge document\",\"description\":\"Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in 'pending' status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\",\"dateModified\":\"2026-11-10T17:38:57.619Z\",\"isPartOf\":{\"@id\":\"https://help.semji.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Knowledge Documents\",\"item\":\"https://help.semji.com/api-reference/knowledge-documents/list-knowledge-documents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a page knowledge document\",\"item\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document#apireference\",\"headline\":\"Create a page knowledge document\",\"name\":\"Create a page knowledge document\",\"description\":\"Creates a knowledge document from exactly one source: text (content), a web page (url) or a file (fileName and size in bytes). The document starts in 'pending' status while it is processed. For a file, the response also carries upload, a presigned S3 POST form valid for 15 minutes: send a multipart POST to upload.url with every upload.fields entry first, then the file as the file field, which must come last. Processing starts once the file is in storage, with no further call. Files go up to 50 MB; accepted types: pdf, csv, txt, xlsx, docx. A 403 on a file means the V2 knowledge base or direct upload is not enabled for the workspace, or the user is a guest writer: only workspace owners and members manage knowledge base files. Refusals: 400 knowledge_document_upload_type_not_allowed, 400 knowledge_document_upload_too_large, 422 knowledge_document_replacement_invalid. The document is attached to the page.\",\"url\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document\",\"mainEntityOfPage\":{\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-page-knowledge-document#webpage\"},\"dateModified\":\"2026-11-10T17:38:57.619Z\",\"publisher\":{\"@id\":\"https://help.semji.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.semji.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Semji Help Center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Semji Help Center","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Home","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/house.svg","pages":[{"title":"Home","href":""}]},{"tab":"Getting Started","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/rocket-launch.svg","pages":[{"title":"Getting Started","href":"/en/getting-started/first-steps"}]},{"tab":"Help Center","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/lifebuoy.svg","pages":[{"title":"Help Center","href":"/en/identify-opportunities/overview"}]},{"tab":"Developer","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/code.svg","anchors":[{"anchor":"Quickstart","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/rocket-launch.svg","pages":[{"title":"Quickstart","href":"/developers/overview"}]},{"anchor":"Guides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/book-open-text.svg","pages":[{"title":"Guides","href":"/guides/overview"}]},{"anchor":"API Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/code.svg","groups":[{"group":"Overview","pages":[{"title":"Semji API overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Me","pages":[{"title":"Get authenticated user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/me","href":"/api-reference/me/get-authenticated-user"}]},{"group":"Users","pages":[{"title":"List organization members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/users","href":"/api-reference/users/list-organization-members"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get workspace details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/get-workspace-details"},{"title":"List workspace members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/users","href":"/api-reference/workspaces/list-workspace-members"},{"title":"List content statuses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/content-statuses","href":"/api-reference/workspaces/list-content-statuses"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/folders","href":"/api-reference/folders/list-folders"},{"title":"Create a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/folders","href":"/api-reference/folders/create-a-folder"},{"title":"Update a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/folders/{folderId}","href":"/api-reference/folders/update-a-folder"},{"title":"Delete a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/folders/{folderId}","href":"/api-reference/folders/delete-a-folder"}]},{"group":"Pages","pages":[{"title":"List pages in a workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/pages","href":"/api-reference/pages/list-pages-in-a-workspace"},{"title":"Import a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/pages","href":"/api-reference/pages/import-a-page"},{"title":"Get page details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}","href":"/api-reference/pages/get-page-details"},{"title":"Update a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/pages/{pageId}","href":"/api-reference/pages/update-a-page"},{"title":"Delete a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/pages/{pageId}","href":"/api-reference/pages/delete-a-page"},{"title":"Crawl a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/crawl","href":"/api-reference/pages/crawl-a-page"}]},{"group":"Contents","pages":[{"title":"List contents in a workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/contents","href":"/api-reference/contents/list-contents-in-a-workspace"},{"title":"Create a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/contents","href":"/api-reference/contents/create-a-content"},{"title":"List contents for a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/contents","href":"/api-reference/contents/list-contents-for-a-page"},{"title":"Get content details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/contents/{contentId}","href":"/api-reference/contents/get-content-details"},{"title":"Update a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/contents/{contentId}","href":"/api-reference/contents/update-a-content"},{"title":"Delete a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/contents/{contentId}","href":"/api-reference/contents/delete-a-content"},{"title":"Mark a content as published","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/publish","href":"/api-reference/contents/mark-a-content-as-published"},{"title":"Generate Atomic Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/atomic","href":"/api-reference/contents/generate-atomic-content"}]},{"group":"Content Generations","pages":[{"title":"Get generation status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/contents/{contentId}/generation","href":"/api-reference/content-generations/get-generation-status"},{"title":"Confirm a generation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/generation/confirm","href":"/api-reference/content-generations/confirm-a-generation"},{"title":"Cancel a generation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/generation/cancel","href":"/api-reference/content-generations/cancel-a-generation"}]},{"group":"Content Ideas","pages":[{"title":"Start a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/content-idea-searches","href":"/api-reference/content-ideas/start-a-content-idea-search"},{"title":"Get a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/content-idea-searches/{contentIdeaSearchId}","href":"/api-reference/content-ideas/get-a-content-idea-search"},{"title":"Delete a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/content-idea-searches/{contentIdeaSearchId}","href":"/api-reference/content-ideas/delete-a-content-idea-search"},{"title":"List content ideas of a search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/content-idea-searches/{contentIdeaSearchId}/content-ideas","href":"/api-reference/content-ideas/list-content-ideas-of-a-search"}]},{"group":"Credit Usages","pages":[{"title":"List credit usages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/credit-usages","href":"/api-reference/credit-usages/list-credit-usages"}]},{"group":"Keywords","pages":[{"title":"List keywords for a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/keywords","href":"/api-reference/keywords/list-keywords-for-a-page"},{"title":"Add a keyword to a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/keywords","href":"/api-reference/keywords/add-a-keyword-to-a-page"},{"title":"Get keyword details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/keywords/{keywordId}","href":"/api-reference/keywords/get-keyword-details"},{"title":"Update a keyword","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/keywords/{keywordId}","href":"/api-reference/keywords/update-a-keyword"},{"title":"Launch keyword analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/analyze","href":"/api-reference/keywords/launch-keyword-analysis"},{"title":"Generate keyword analysis report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/report","href":"/api-reference/keywords/generate-keyword-analysis-report"}]},{"group":"Prompts","pages":[{"title":"List prompts for a keyword","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/keywords/{keywordId}/prompts","href":"/api-reference/prompts/list-prompts-for-a-keyword"},{"title":"Create a prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/prompts","href":"/api-reference/prompts/create-a-prompt"},{"title":"Get prompt details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/prompts/{promptId}","href":"/api-reference/prompts/get-prompt-details"},{"title":"Launch prompt analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/prompts/{promptId}/analyze","href":"/api-reference/prompts/launch-prompt-analysis"},{"title":"Generate prompt analysis report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/prompts/{promptId}/report","href":"/api-reference/prompts/generate-prompt-analysis-report"}]},{"group":"Brand Voices","pages":[{"title":"List brand voices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/brand-voices","href":"/api-reference/brand-voices/list-brand-voices"},{"title":"Get brand voice details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/brand-voices/{brandVoiceId}","href":"/api-reference/brand-voices/get-brand-voice-details"}]},{"group":"Knowledge Documents","pages":[{"title":"List knowledge documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/list-knowledge-documents"},{"title":"Get knowledge document details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/get-knowledge-document-details"},{"title":"Create a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-knowledge-document"},{"title":"Update a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/update-a-knowledge-document"},{"title":"Delete a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/delete-a-knowledge-document"},{"title":"Validate a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/knowledge-documents/{knowledgeDocumentId}/validation","href":"/api-reference/knowledge-documents/validate-a-knowledge-document"},{"title":"Preview a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/knowledge-documents/{knowledgeDocumentId}/preview","href":"/api-reference/knowledge-documents/preview-a-knowledge-document"},{"title":"List page knowledge documents","description":"Returns the knowledge documents attached to a page. They do not appear in the workspace listing.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/list-page-knowledge-documents"},{"title":"Create a page knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-page-knowledge-document"},{"title":"List knowledge folders","description":"Lists the knowledge folders of a workspace. A knowledge document created without `knowledgeFolderId` goes to the General folder, which is not part of this list.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/list-knowledge-folders"},{"title":"Create a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/create-a-knowledge-folder"},{"title":"Update a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/knowledge-folders/{knowledgeFolderId}","href":"/api-reference/knowledge-documents/update-a-knowledge-folder"},{"title":"Delete a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/knowledge-folders/{knowledgeFolderId}","href":"/api-reference/knowledge-documents/delete-a-knowledge-folder"},{"title":"File knowledge documents in a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/file-knowledge-documents-in-a-folder"}]}]},{"anchor":"Webhooks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/webhooks-logo.svg","pages":[{"title":"Webhooks","href":"/integrations/overview"}]},{"anchor":"Agents (MCP)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/robot.svg","pages":[{"title":"Agents (MCP)","href":"/mcp/overview"}]}]},{"tab":"Status","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/heartbeat.svg","href":"https://status.semji.com/"}]},{"language":"fr","tabs":[{"tab":"Home","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/house.svg","pages":[{"title":"Home","href":"/fr"}]},{"tab":"Prise en main","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/rocket-launch.svg","pages":[{"title":"Prise en main","href":"/fr/getting-started/first-steps"}]},{"tab":"Centre d'aide","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/lifebuoy.svg","pages":[{"title":"Centre d'aide","href":"/fr/identify-opportunities/overview"}]},{"tab":"Developer","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/code.svg","anchors":[{"anchor":"Quickstart","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/rocket-launch.svg","pages":[{"title":"Quickstart","href":"/developers/overview"}]},{"anchor":"Guides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/book-open-text.svg","pages":[{"title":"Guides","href":"/guides/overview"}]},{"anchor":"API Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/code.svg","groups":[{"group":"Overview","pages":[{"title":"Semji API overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Me","pages":[{"title":"Get authenticated user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/me","href":"/api-reference/me/get-authenticated-user"}]},{"group":"Users","pages":[{"title":"List organization members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/users","href":"/api-reference/users/list-organization-members"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get workspace details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/get-workspace-details"},{"title":"List workspace members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/users","href":"/api-reference/workspaces/list-workspace-members"},{"title":"List content statuses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/content-statuses","href":"/api-reference/workspaces/list-content-statuses"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/folders","href":"/api-reference/folders/list-folders"},{"title":"Create a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/folders","href":"/api-reference/folders/create-a-folder"},{"title":"Update a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/folders/{folderId}","href":"/api-reference/folders/update-a-folder"},{"title":"Delete a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/folders/{folderId}","href":"/api-reference/folders/delete-a-folder"}]},{"group":"Pages","pages":[{"title":"List pages in a workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/pages","href":"/api-reference/pages/list-pages-in-a-workspace"},{"title":"Import a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/pages","href":"/api-reference/pages/import-a-page"},{"title":"Get page details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}","href":"/api-reference/pages/get-page-details"},{"title":"Update a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/pages/{pageId}","href":"/api-reference/pages/update-a-page"},{"title":"Delete a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/pages/{pageId}","href":"/api-reference/pages/delete-a-page"},{"title":"Crawl a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/crawl","href":"/api-reference/pages/crawl-a-page"}]},{"group":"Contents","pages":[{"title":"List contents in a workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/contents","href":"/api-reference/contents/list-contents-in-a-workspace"},{"title":"Create a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/contents","href":"/api-reference/contents/create-a-content"},{"title":"List contents for a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/contents","href":"/api-reference/contents/list-contents-for-a-page"},{"title":"Get content details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/contents/{contentId}","href":"/api-reference/contents/get-content-details"},{"title":"Update a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/contents/{contentId}","href":"/api-reference/contents/update-a-content"},{"title":"Delete a content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/contents/{contentId}","href":"/api-reference/contents/delete-a-content"},{"title":"Mark a content as published","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/publish","href":"/api-reference/contents/mark-a-content-as-published"},{"title":"Generate Atomic Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/atomic","href":"/api-reference/contents/generate-atomic-content"}]},{"group":"Content Generations","pages":[{"title":"Get generation status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/contents/{contentId}/generation","href":"/api-reference/content-generations/get-generation-status"},{"title":"Confirm a generation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/generation/confirm","href":"/api-reference/content-generations/confirm-a-generation"},{"title":"Cancel a generation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/contents/{contentId}/generation/cancel","href":"/api-reference/content-generations/cancel-a-generation"}]},{"group":"Content Ideas","pages":[{"title":"Start a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/content-idea-searches","href":"/api-reference/content-ideas/start-a-content-idea-search"},{"title":"Get a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/content-idea-searches/{contentIdeaSearchId}","href":"/api-reference/content-ideas/get-a-content-idea-search"},{"title":"Delete a content idea search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/content-idea-searches/{contentIdeaSearchId}","href":"/api-reference/content-ideas/delete-a-content-idea-search"},{"title":"List content ideas of a search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/content-idea-searches/{contentIdeaSearchId}/content-ideas","href":"/api-reference/content-ideas/list-content-ideas-of-a-search"}]},{"group":"Credit Usages","pages":[{"title":"List credit usages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/credit-usages","href":"/api-reference/credit-usages/list-credit-usages"}]},{"group":"Keywords","pages":[{"title":"List keywords for a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/keywords","href":"/api-reference/keywords/list-keywords-for-a-page"},{"title":"Add a keyword to a page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/keywords","href":"/api-reference/keywords/add-a-keyword-to-a-page"},{"title":"Get keyword details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/keywords/{keywordId}","href":"/api-reference/keywords/get-keyword-details"},{"title":"Update a keyword","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/keywords/{keywordId}","href":"/api-reference/keywords/update-a-keyword"},{"title":"Launch keyword analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/analyze","href":"/api-reference/keywords/launch-keyword-analysis"},{"title":"Generate keyword analysis report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/report","href":"/api-reference/keywords/generate-keyword-analysis-report"}]},{"group":"Prompts","pages":[{"title":"List prompts for a keyword","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/keywords/{keywordId}/prompts","href":"/api-reference/prompts/list-prompts-for-a-keyword"},{"title":"Create a prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keywords/{keywordId}/prompts","href":"/api-reference/prompts/create-a-prompt"},{"title":"Get prompt details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/prompts/{promptId}","href":"/api-reference/prompts/get-prompt-details"},{"title":"Launch prompt analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/prompts/{promptId}/analyze","href":"/api-reference/prompts/launch-prompt-analysis"},{"title":"Generate prompt analysis report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/prompts/{promptId}/report","href":"/api-reference/prompts/generate-prompt-analysis-report"}]},{"group":"Brand Voices","pages":[{"title":"List brand voices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/brand-voices","href":"/api-reference/brand-voices/list-brand-voices"},{"title":"Get brand voice details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/brand-voices/{brandVoiceId}","href":"/api-reference/brand-voices/get-brand-voice-details"}]},{"group":"Knowledge Documents","pages":[{"title":"List knowledge documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/list-knowledge-documents"},{"title":"Get knowledge document details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/get-knowledge-document-details"},{"title":"Create a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-knowledge-document"},{"title":"Update a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/update-a-knowledge-document"},{"title":"Delete a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/knowledge-documents/{knowledgeDocumentId}","href":"/api-reference/knowledge-documents/delete-a-knowledge-document"},{"title":"Validate a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/knowledge-documents/{knowledgeDocumentId}/validation","href":"/api-reference/knowledge-documents/validate-a-knowledge-document"},{"title":"Preview a knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/knowledge-documents/{knowledgeDocumentId}/preview","href":"/api-reference/knowledge-documents/preview-a-knowledge-document"},{"title":"List page knowledge documents","description":"Returns the knowledge documents attached to a page. They do not appear in the workspace listing.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/list-page-knowledge-documents"},{"title":"Create a page knowledge document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/pages/{pageId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-page-knowledge-document"},{"title":"List knowledge folders","description":"Lists the knowledge folders of a workspace. A knowledge document created without `knowledgeFolderId` goes to the General folder, which is not part of this list.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/list-knowledge-folders"},{"title":"Create a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/create-a-knowledge-folder"},{"title":"Update a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/knowledge-folders/{knowledgeFolderId}","href":"/api-reference/knowledge-documents/update-a-knowledge-folder"},{"title":"Delete a knowledge folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/knowledge-folders/{knowledgeFolderId}","href":"/api-reference/knowledge-documents/delete-a-knowledge-folder"},{"title":"File knowledge documents in a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/workspaces/{workspaceId}/knowledge-folders","href":"/api-reference/knowledge-documents/file-knowledge-documents-in-a-folder"}]}]},{"anchor":"Webhooks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/webhooks-logo.svg","pages":[{"title":"Webhooks","href":"/integrations/overview"}]},{"anchor":"Agents (MCP)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/robot.svg","pages":[{"title":"Agents (MCP)","href":"/mcp/overview"}]}]},{"tab":"Status","icon":"https://mintlify.s3.us-west-1.amazonaws.com/semji/images/icons/phosphor/heartbeat.svg","href":"https://status.semji.com/"}]}]},"basePath":"","title":"Create a page knowledge document - Semji Help Center","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}