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.
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-knowledge-document","slug":"/api-reference/knowledge-documents/create-a-knowledge-document","pageMetadata":{"title":"Create a 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.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-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.\"]\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 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.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/workspaces/{workspaceId}/knowledge-documents","href":"/api-reference/knowledge-documents/create-a-knowledge-document","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a 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.","requestBody":"83bc12d9-0ce9-4f93-bf62-0e4ebfd11139","parameters":["d8ce7c25-20fa-48d0-a02b-a61338f94bac"],"responses":{"201":"e5bbca4a-a044-4fdd-9f09-dadc193d9d45"},"method":"post","type":"path","servers":[],"security":["881f5ee2-97c0-4b22-a0d3-3510f523597d"],"path":"/v1/workspaces/{workspaceId}/knowledge-documents","baseUrlOptions":[],"title":"Create a knowledge document","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d8ce7c25-20fa-48d0-a02b-a61338f94bac":{"schema":{"type":"string","isRequired":true,"description":"Workspace ID.","uniqueKey":"","typeLabel":"string"},"in":"path","name":"workspaceId","required":true,"description":"Workspace 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"},"knowledgeFolderId":{"description":"Folder that will hold the document. Omit it to file the document in General.","type":"string","uniqueKey":"knowledgeFolderId","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>","knowledgeFolderId":"\u003cstring>","replaces":["\u003cstring>"],"size":1,"url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e5bbca4a-a044-4fdd-9f09-dadc193d9d45":{"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 knowledge document - Semji Help Center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/knowledge-documents/create-a-knowledge-document","matchLevel":0},"fr":{"href":"/api-reference/knowledge-documents/create-a-knowledge-document","matchLevel":0}}},"lastModified":"2026-11-10T17:38:57.493Z","originalFileLocation":"api-reference/knowledge-documents/create-a-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.\">\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 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.\">\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-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+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=2aac16b6d7f3b995b75807f66adae04fc4b39bc3052c23c0ba53d153befdcb3b\">\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 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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://semji.mintlify.site/_mintlify/api/og/v2?division=Knowledge+Documents\u0026amp;title=Create+a+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=2aac16b6d7f3b995b75807f66adae04fc4b39bc3052c23c0ba53d153befdcb3b\">\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-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-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-knowledge-document#webpage\",\"url\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document\",\"name\":\"Create a 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.\",\"dateModified\":\"2026-11-10T17:38:57.493Z\",\"isPartOf\":{\"@id\":\"https://help.semji.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-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 knowledge document\",\"item\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document#apireference\",\"headline\":\"Create a knowledge document\",\"name\":\"Create a 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.\",\"url\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document\",\"mainEntityOfPage\":{\"@id\":\"https://help.semji.com/api-reference/knowledge-documents/create-a-knowledge-document#webpage\"},\"dateModified\":\"2026-11-10T17:38:57.493Z\",\"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","description":"Returns details of a knowledge document, with its indexed content.","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","description":"Updates the name, summary or text content of a knowledge document. Omitted fields keep their value. Any update re-indexes the document, which goes back to `pending` until indexing ends. `content` is only accepted on text documents. A document that is `pending` or `failed` cannot be updated and answers 409.","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","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","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","description":"Returns details of a knowledge document, with its indexed content.","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","description":"Updates the name, summary or text content of a knowledge document. Omitted fields keep their value. Any update re-indexes the document, which goes back to `pending` until indexing ends. `content` is only accepted on text documents. A document that is `pending` or `failed` cannot be updated and answers 409.","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","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","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 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"]}