curl --request POST \ --url 'https://api-prod.usefini.com/v2/knowledge/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": true }'
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/knowledge/public", headers={ "Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json", }, json={ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": True, },)job = response.json()
const response = await fetch("https://api-prod.usefini.com/v2/knowledge/public", { method: "POST", headers: { Authorization: "Bearer fini_your_api_key", "Content-Type": "application/json", }, body: JSON.stringify({ candidateKnowledge: "Customers on annual plans can cancel at the end of the current billing term.", origin: "MAGIC_ARTICLE", botId: "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", isDraft: true, }),});const job = await response.json();
Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.
POST
/
v2
/
knowledge
/
public
curl --request POST \ --url 'https://api-prod.usefini.com/v2/knowledge/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": true }'
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/knowledge/public", headers={ "Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json", }, json={ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": True, },)job = response.json()
const response = await fetch("https://api-prod.usefini.com/v2/knowledge/public", { method: "POST", headers: { Authorization: "Bearer fini_your_api_key", "Content-Type": "application/json", }, body: JSON.stringify({ candidateKnowledge: "Customers on annual plans can cancel at the end of the current billing term.", origin: "MAGIC_ARTICLE", botId: "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", isDraft: true, }),});const job = await response.json();
Use this route when you already have the candidate content you want to turn into knowledge and need Fini to process it as a single background job.
This route always requires candidateKnowledge. If you want Fini to generate directly from stored source content, use Bulk generate knowledge instead. isDraft defaults to true.
Optional operation restrictions passed through to the generation pipeline. Use this to limit what Fini is allowed to do when it decides how to apply the generated knowledge.
Use restrictedOps to limit the operation choices available to the knowledge-generation pipeline for that request.
Value
Meaning
ADD_ARTICLE_TO_FOLDER
Allow Fini to create a new article in an existing folder.
UPDATE_ARTICLE
Allow Fini to update an existing article that the pipeline selects as the best match.
DO_NOTHING
Allow Fini to decide that no knowledge change should be applied. When isDraft is true, this still creates a reviewable draft/no-op record.
curl --request POST \ --url 'https://api-prod.usefini.com/v2/knowledge/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": true }'
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/knowledge/public", headers={ "Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json", }, json={ "candidateKnowledge": "Customers on annual plans can cancel at the end of the current billing term.", "origin": "MAGIC_ARTICLE", "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "isDraft": True, },)job = response.json()
const response = await fetch("https://api-prod.usefini.com/v2/knowledge/public", { method: "POST", headers: { Authorization: "Bearer fini_your_api_key", "Content-Type": "application/json", }, body: JSON.stringify({ candidateKnowledge: "Customers on annual plans can cancel at the end of the current billing term.", origin: "MAGIC_ARTICLE", botId: "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", isDraft: true, }),});const job = await response.json();
Poll the queued job with Check knowledge jobs. If you left isDraft at its default true, review or publish the resulting draft before expecting live agent answers to change.
The request body is malformed, candidateKnowledge is missing, origin is invalid, or the origin-specific required field is missing.
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
The API key does not include the write scope.
Generation completed but nothing changed live
Expected when isDraft was left at its default true. Poll the job status, then review or publish the resulting draft through the article workflow.
500 Internal Server Error
Fini failed while queueing or processing the generation job. Retry once, then inspect the job with Check knowledge jobs.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Fini","description":"Documentation for Fini AI (usefini.com): build, deploy and run autonomous AI support agents. Fini is made by Fini Technologies Inc. and is not affiliated with fini.ai.","colors":{"primary":"#C3EE5E","light":"#C3EE5E","dark":"#A8D43E"},"logo":{"light":"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-light.png?fit=max\u0026auto=format\u0026n=fep-JMymNphpe1DQ\u0026q=85\u0026s=a460ff8bb507876712db2f0fb12c21e4","dark":"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026auto=format\u0026n=fep-JMymNphpe1DQ\u0026q=85\u0026s=8a2bf1d8a0e5c590ebb976eadccf26a9"},"favicon":"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026auto=format\u0026n=fep-JMymNphpe1DQ\u0026q=85\u0026s=8a2bf1d8a0e5c590ebb976eadccf26a9","footer":{"socials":{"x":"https://x.com/finichatAI","linkedin":"https://www.linkedin.com/company/usefini","youtube":"https://www.youtube.com/@finiai","instagram":"https://www.instagram.com/usefini.official","github":"https://github.com/ask-fini"}},"seo":{"metatags":{"msvalidate.01":"9A9FD7AB87AE2DEA257FE41F07C61E70"}},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fini","hasAudioNarration":false,"actualSubdomain":"fini","customDomains":["docs.usefini.com"],"gitSource":{"type":"github","owner":"ask-fini","repo":"fini-docs","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9b4c42d9111c67b1782b8","collectionId":"ecc3dbe0-e245-4b84-9640-917bebb403ea","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9b4c42d9111c67b1782b8"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9b4c42d9111c67b1782b8","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"en","tag":"API reference","count":207},{"language":"en","tag":"Documentation","count":56},{"language":"en","tag":"Knowledge","count":40},{"language":"en","tag":"Test Suite","count":31},{"language":"en","tag":"Use cases","count":29},{"language":"en","tag":"Deploy","count":21},{"language":"en","tag":"Intent Rules","count":18},{"language":"en","tag":"Conversations","count":14},{"language":"en","tag":"Integrations","count":14},{"language":"en","tag":"Agent Configuration","count":13}]},"assistantConfig":{"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/generate-knowledge","slug":"/en/api-reference/generate-knowledge","pageMetadata":{"title":"Generate knowledge","api":"POST https://api-prod.usefini.com/v2/knowledge/public","description":"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.","href":"/en/api-reference/generate-knowledge"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Heading,Info,ParamField,ResponseField,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use this route when you already have the candidate content you want to turn into knowledge and need Fini to process it as a single background job.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`This route always requires `,_jsx(_components.code,{children:`candidateKnowledge`}),`. If you want Fini to generate directly from stored source content, use `,_jsx(_components.a,{href:`/en/api-reference/bulk-generate-knowledge`,children:`Bulk generate knowledge`}),` instead. `,_jsx(_components.code,{children:`isDraft`}),` defaults to `,_jsx(_components.code,{children:`true`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`origins`,children:`Origins`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Origin`}),_jsx(_components.th,{children:`Use it for`}),_jsx(_components.th,{children:`Extra required field`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`MAGIC_ARTICLE`})}),_jsx(_components.td,{children:`Raw candidate text that is not tied to another Fini record`}),_jsx(_components.td,{children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SOURCE_IMPORT`})}),_jsx(_components.td,{children:`Candidate text you want to associate with one ingested source record`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`documentId`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INBOX_SUGGESTION`})}),_jsx(_components.td,{children:`Candidate text you want to associate with one inbox event`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`hcEventId`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`Bearer token containing your Fini workspace API key. Format: `,_jsx(_components.code,{children:`Bearer fini_...`}),` The key needs `,_jsx(_components.code,{children:`write`}),` scope.`]})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`application/json`})})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsx(ParamField,{body:`candidateKnowledge`,type:`string`,required:true,id:`param-candidate-knowledge`,children:_jsx(_components.p,{children:`Candidate content to turn into knowledge.`})}),`\n`,_jsx(ParamField,{body:`origin`,type:`string`,required:true,id:`param-origin`,children:_jsxs(_components.p,{children:[`Origin for the content. Allowed values are `,_jsx(_components.code,{children:`MAGIC_ARTICLE`}),`, `,_jsx(_components.code,{children:`SOURCE_IMPORT`}),`, and `,_jsx(_components.code,{children:`INBOX_SUGGESTION`}),`.`]})}),`\n`,_jsx(ParamField,{body:`documentId`,type:`string`,id:`param-document-id`,children:_jsxs(_components.p,{children:[`Required when `,_jsx(_components.code,{children:`origin`}),` is `,_jsx(_components.code,{children:`SOURCE_IMPORT`}),`. This is the ingested source ID you want to link the generated result to.`]})}),`\n`,_jsx(ParamField,{body:`hcEventId`,type:`string`,id:`param-hc-event-id`,children:_jsxs(_components.p,{children:[`Required when `,_jsx(_components.code,{children:`origin`}),` is `,_jsx(_components.code,{children:`INBOX_SUGGESTION`}),`. This is the inbox event ID you want to link the generated result to.`]})}),`\n`,_jsx(ParamField,{body:`restrictedOps`,type:`array`,id:`param-restricted-ops`,children:_jsx(_components.p,{children:`Optional operation restrictions passed through to the generation pipeline. Use this to limit what Fini is allowed to do when it decides how to apply the generated knowledge.`})}),`\n`,_jsx(ParamField,{body:`instructions`,type:`string`,id:`param-instructions`,children:_jsx(_components.p,{children:`Additional generation instructions.`})}),`\n`,_jsx(ParamField,{body:`botId`,type:`string`,id:`param-bot-id`,children:_jsx(_components.p,{children:`Optional agent ID to scope the generated content to.`})}),`\n`,_jsx(ParamField,{body:`isDraft`,type:`boolean`,default:true,id:`param-is-draft`,children:_jsx(_components.p,{children:`Whether the generated result should remain a draft.`})}),`\n`,_jsxs(Heading,{level:`2`,id:`restrictedops-values`,children:[_jsx(_components.code,{children:`restrictedOps`}),` values`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`restrictedOps`}),` to limit the operation choices available to the knowledge-generation pipeline for that request.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_ARTICLE_TO_FOLDER`})}),_jsx(_components.td,{children:`Allow Fini to create a new article in an existing folder.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UPDATE_ARTICLE`})}),_jsx(_components.td,{children:`Allow Fini to update an existing article that the pipeline selects as the best match.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DO_NOTHING`})}),_jsxs(_components.td,{children:[`Allow Fini to decide that no knowledge change should be applied. When `,_jsx(_components.code,{children:`isDraft`}),` is `,_jsx(_components.code,{children:`true`}),`, this still creates a reviewable draft/no-op record.`]})]})]})]}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`backgroundJobId`,type:`string`,id:`param-background-job-id`,children:_jsx(_components.p,{children:`Background job ID for the queued generation request.`})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsxs(_components.p,{children:[`Poll the queued job with `,_jsx(_components.a,{href:`/en/api-reference/check-knowledge-jobs`,children:`Check knowledge jobs`}),`. If you left `,_jsx(_components.code,{children:`isDraft`}),` at its default `,_jsx(_components.code,{children:`true`}),`, review or publish the resulting draft before expecting live agent answers to change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`400 Bad Request`,icon:`circle-exclamation`,id:`400-bad-request`,children:_jsxs(_components.p,{children:[`The request body is malformed, `,_jsx(_components.code,{children:`candidateKnowledge`}),` is missing, `,_jsx(_components.code,{children:`origin`}),` is invalid, or the origin-specific required field is missing.`]})}),_jsx(Accordion,{title:`401 Unauthorized`,icon:`lock`,id:`401-unauthorized`,children:_jsx(_components.p,{children:`The API key is missing, malformed, revoked, or invalid.`})}),_jsx(Accordion,{title:`403 Forbidden`,icon:`shield-halved`,id:`403-forbidden`,children:_jsxs(_components.p,{children:[`The API key does not include the `,_jsx(_components.code,{children:`write`}),` scope.`]})}),_jsx(Accordion,{title:`Generation completed but nothing changed live`,icon:`circle-question`,id:`generation-completed-but-nothing-changed-live`,children:_jsxs(_components.p,{children:[`Expected when `,_jsx(_components.code,{children:`isDraft`}),` was left at its default `,_jsx(_components.code,{children:`true`}),`. Poll the job status, then review or publish the resulting draft through the article workflow.`]})}),_jsx(Accordion,{title:`500 Internal Server Error`,icon:`triangle-exclamation`,id:`500-internal-server-error`,children:_jsxs(_components.p,{children:[`Fini failed while queueing or processing the generation job. Retry once, then inspect the job with `,_jsx(_components.a,{href:`/en/api-reference/check-knowledge-jobs`,children:`Check knowledge jobs`}),`.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate knowledge","api":"POST https://api-prod.usefini.com/v2/knowledge/public","description":"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.","href":"/en/api-reference/generate-knowledge"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Info,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use this route when you already have the candidate content you want to turn into knowledge and need Fini to process it as a single background job.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`This route always requires `,_jsx(_components.code,{children:`candidateKnowledge`}),`. If you want Fini to generate directly from stored source content, use `,_jsx(_components.a,{href:`/en/api-reference/bulk-generate-knowledge`,children:`Bulk generate knowledge`}),` instead. `,_jsx(_components.code,{children:`isDraft`}),` defaults to `,_jsx(_components.code,{children:`true`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`origins`,children:`Origins`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Origin`}),_jsx(_components.th,{children:`Use it for`}),_jsx(_components.th,{children:`Extra required field`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`MAGIC_ARTICLE`})}),_jsx(_components.td,{children:`Raw candidate text that is not tied to another Fini record`}),_jsx(_components.td,{children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SOURCE_IMPORT`})}),_jsx(_components.td,{children:`Candidate text you want to associate with one ingested source record`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`documentId`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INBOX_SUGGESTION`})}),_jsx(_components.td,{children:`Candidate text you want to associate with one inbox event`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`hcEventId`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`Bearer token containing your Fini workspace API key. Format: `,_jsx(_components.code,{children:`Bearer fini_...`}),` The key needs `,_jsx(_components.code,{children:`write`}),` scope.`]})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:_jsx(_components.code,{children:`application/json`})})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsx(ParamField,{body:`candidateKnowledge`,type:`string`,required:true,id:`param-candidate-knowledge`,children:_jsx(_components.p,{children:`Candidate content to turn into knowledge.`})}),`\n`,_jsx(ParamField,{body:`origin`,type:`string`,required:true,id:`param-origin`,children:_jsxs(_components.p,{children:[`Origin for the content. Allowed values are `,_jsx(_components.code,{children:`MAGIC_ARTICLE`}),`, `,_jsx(_components.code,{children:`SOURCE_IMPORT`}),`, and `,_jsx(_components.code,{children:`INBOX_SUGGESTION`}),`.`]})}),`\n`,_jsx(ParamField,{body:`documentId`,type:`string`,id:`param-document-id`,children:_jsxs(_components.p,{children:[`Required when `,_jsx(_components.code,{children:`origin`}),` is `,_jsx(_components.code,{children:`SOURCE_IMPORT`}),`. This is the ingested source ID you want to link the generated result to.`]})}),`\n`,_jsx(ParamField,{body:`hcEventId`,type:`string`,id:`param-hc-event-id`,children:_jsxs(_components.p,{children:[`Required when `,_jsx(_components.code,{children:`origin`}),` is `,_jsx(_components.code,{children:`INBOX_SUGGESTION`}),`. This is the inbox event ID you want to link the generated result to.`]})}),`\n`,_jsx(ParamField,{body:`restrictedOps`,type:`array`,id:`param-restricted-ops`,children:_jsx(_components.p,{children:`Optional operation restrictions passed through to the generation pipeline. Use this to limit what Fini is allowed to do when it decides how to apply the generated knowledge.`})}),`\n`,_jsx(ParamField,{body:`instructions`,type:`string`,id:`param-instructions`,children:_jsx(_components.p,{children:`Additional generation instructions.`})}),`\n`,_jsx(ParamField,{body:`botId`,type:`string`,id:`param-bot-id`,children:_jsx(_components.p,{children:`Optional agent ID to scope the generated content to.`})}),`\n`,_jsx(ParamField,{body:`isDraft`,type:`boolean`,default:true,id:`param-is-draft`,children:_jsx(_components.p,{children:`Whether the generated result should remain a draft.`})}),`\n`,_jsxs(Heading,{level:`2`,id:`restrictedops-values`,children:[_jsx(_components.code,{children:`restrictedOps`}),` values`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`restrictedOps`}),` to limit the operation choices available to the knowledge-generation pipeline for that request.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_ARTICLE_TO_FOLDER`})}),_jsx(_components.td,{children:`Allow Fini to create a new article in an existing folder.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UPDATE_ARTICLE`})}),_jsx(_components.td,{children:`Allow Fini to update an existing article that the pipeline selects as the best match.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DO_NOTHING`})}),_jsxs(_components.td,{children:[`Allow Fini to decide that no knowledge change should be applied. When `,_jsx(_components.code,{children:`isDraft`}),` is `,_jsx(_components.code,{children:`true`}),`, this still creates a reviewable draft/no-op record.`]})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api-prod.usefini.com/v2/knowledge/public'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer fini_your_api_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"candidateKnowledge\": \"Customers on annual plans can cancel at the end of the current billing term.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"origin\": \"MAGIC_ARTICLE\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"botId\": \"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"isDraft\": true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`16`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api-prod.usefini.com/v2/knowledge/public\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer fini_your_api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"candidateKnowledge\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Customers on annual plans can cancel at the end of the current billing term.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"origin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MAGIC_ARTICLE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"botId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"isDraft\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`job `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`15`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api-prod.usefini.com/v2/knowledge/public\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer fini_your_api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` candidateKnowledge:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Customers on annual plans can cancel at the end of the current billing term.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` origin:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"MAGIC_ARTICLE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` botId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` isDraft:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` job`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`backgroundJobId`,type:`string`,id:`param-background-job-id`,children:_jsx(_components.p,{children:`Background job ID for the queued generation request.`})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200 OK`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"backgroundJobId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4cfcf2cc-7a06-4de2-b460-5b991fe6236a\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsxs(_components.p,{children:[`Poll the queued job with `,_jsx(_components.a,{href:`/en/api-reference/check-knowledge-jobs`,children:`Check knowledge jobs`}),`. If you left `,_jsx(_components.code,{children:`isDraft`}),` at its default `,_jsx(_components.code,{children:`true`}),`, review or publish the resulting draft before expecting live agent answers to change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`400 Bad Request`,icon:`circle-exclamation`,id:`400-bad-request`,children:_jsxs(_components.p,{children:[`The request body is malformed, `,_jsx(_components.code,{children:`candidateKnowledge`}),` is missing, `,_jsx(_components.code,{children:`origin`}),` is invalid, or the origin-specific required field is missing.`]})}),_jsx(Accordion,{title:`401 Unauthorized`,icon:`lock`,id:`401-unauthorized`,children:_jsx(_components.p,{children:`The API key is missing, malformed, revoked, or invalid.`})}),_jsx(Accordion,{title:`403 Forbidden`,icon:`shield-halved`,id:`403-forbidden`,children:_jsxs(_components.p,{children:[`The API key does not include the `,_jsx(_components.code,{children:`write`}),` scope.`]})}),_jsx(Accordion,{title:`Generation completed but nothing changed live`,icon:`circle-question`,id:`generation-completed-but-nothing-changed-live`,children:_jsxs(_components.p,{children:[`Expected when `,_jsx(_components.code,{children:`isDraft`}),` was left at its default `,_jsx(_components.code,{children:`true`}),`. Poll the job status, then review or publish the resulting draft through the article workflow.`]})}),_jsx(Accordion,{title:`500 Internal Server Error`,icon:`triangle-exclamation`,id:`500-internal-server-error`,children:_jsxs(_components.p,{children:[`Fini failed while queueing or processing the generation job. Retry once, then inspect the job with `,_jsx(_components.a,{href:`/en/api-reference/check-knowledge-jobs`,children:`Check knowledge jobs`}),`.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate knowledge","api":"POST https://api-prod.usefini.com/v2/knowledge/public","description":"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.","href":"/en/api-reference/generate-knowledge"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Origins","slug":"origins","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"restrictedOps values","slug":"restrictedops-values","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Next step","slug":"next-step","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --url\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api-prod.usefini.com/v2/knowledge/public'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Authorization: Bearer fini_your_api_key'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"candidateKnowledge\": \"Customers on annual plans can cancel at the end of the current billing term.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"origin\": \"MAGIC_ARTICLE\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"botId\": \"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"isDraft\": true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api-prod.usefini.com/v2/knowledge/public\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Bearer fini_your_api_key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"candidateKnowledge\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Customers on annual plans can cancel at the end of the current billing term.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"origin\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"MAGIC_ARTICLE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"botId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"isDraft\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">True\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">job \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Node.js","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"15\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api-prod.usefini.com/v2/knowledge/public\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"POST\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Bearer fini_your_api_key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> candidateKnowledge:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Customers on annual plans can cancel at the end of the current billing term.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> origin:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"MAGIC_ARTICLE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> botId:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> isDraft:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> job\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200 OK","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"backgroundJobId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"4cfcf2cc-7a06-4de2-b460-5b991fe6236a\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Generate knowledge","path":"/v2/knowledge/public","servers":[{"url":"https://api-prod.usefini.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"Bearer token containing your Fini workspace API key. Format: `Bearer fini_...` The key needs `write` scope.","required":true}]},"Content-Type":{"schema":[{"type":"string","description":"`application/json`","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"candidateKnowledge":[{"type":"string","description":"Candidate content to turn into knowledge.","required":true}],"origin":[{"type":"string","description":"Origin for the content. Allowed values are `MAGIC_ARTICLE` , `SOURCE_IMPORT` , and `INBOX_SUGGESTION` .","required":true}],"documentId":[{"type":"string","description":"Required when `origin` is `SOURCE_IMPORT` . This is the ingested source ID you want to link the generated result to."}],"hcEventId":[{"type":"string","description":"Required when `origin` is `INBOX_SUGGESTION` . This is the inbox event ID you want to link the generated result to."}],"restrictedOps":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Optional operation restrictions passed through to the generation pipeline. Use this to limit what Fini is allowed to do when it decides how to apply the generated knowledge."}],"instructions":[{"type":"string","description":"Additional generation instructions."}],"botId":[{"type":"string","description":"Optional agent ID to scope the generated content to."}],"isDraft":[{"type":"boolean","description":"Whether the generated result should remain a draft."}]}}],"examples":{"example":{"value":{"candidateKnowledge":"\u003cstring>","origin":"\u003cstring>","documentId":"\u003cstring>","hcEventId":"\u003cstring>","restrictedOps":[{}],"instructions":"\u003cstring>","botId":"\u003cstring>","isDraft":true}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"backgroundJobId":[{"type":"string","description":"Background job ID for the queued generation request."}]}}],"examples":{"example":{"value":{"backgroundJobId":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"fini","siteName":"Fini","title":"Generate knowledge - Fini","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/generate-knowledge","matchLevel":0}}},"lastModified":"2026-10-05T17:02:06.970Z","originalFileLocation":"en/api-reference/generate-knowledge.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=\"system\"}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=\"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fini\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026amp;auto=format\u0026amp;n=fep-JMymNphpe1DQ\u0026amp;q=85\u0026amp;s=8a2bf1d8a0e5c590ebb976eadccf26a9\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026amp;auto=format\u0026amp;n=fep-JMymNphpe1DQ\u0026amp;q=85\u0026amp;s=8a2bf1d8a0e5c590ebb976eadccf26a9\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026amp;auto=format\u0026amp;n=fep-JMymNphpe1DQ\u0026amp;q=85\u0026amp;s=8a2bf1d8a0e5c590ebb976eadccf26a9\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-dark.png?fit=max\u0026amp;auto=format\u0026amp;n=fep-JMymNphpe1DQ\u0026amp;q=85\u0026amp;s=8a2bf1d8a0e5c590ebb976eadccf26a9\">\u003cmeta data-mint-head property=\"og:title\" content=\"Generate knowledge - Fini\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fini\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usefini.com/en/api-reference/generate-knowledge\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fini.mintlify.app/_mintlify/api/og/v2?division=Knowledge+generation\u0026amp;title=Generate+knowledge\u0026amp;description=Queue+one+knowledge-generation+job+from+candidate+text%2C+with+optional+source+or+inbox+linkage.\u0026amp;theme=f0910fa1b0920527ac15e186\u0026amp;signature=7abd7dab01b657a688a8cb95df4fd29fa40a5bea96e3f8d804af558fa1039746\">\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=\"Generate knowledge - Fini\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fini.mintlify.app/_mintlify/api/og/v2?division=Knowledge+generation\u0026amp;title=Generate+knowledge\u0026amp;description=Queue+one+knowledge-generation+job+from+candidate+text%2C+with+optional+source+or+inbox+linkage.\u0026amp;theme=f0910fa1b0920527ac15e186\u0026amp;signature=7abd7dab01b657a688a8cb95df4fd29fa40a5bea96e3f8d804af558fa1039746\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/fini/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fini\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C3EE5E\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"9A9FD7AB87AE2DEA257FE41F07C61E70\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usefini.com/en/api-reference/generate-knowledge\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/generate-knowledge.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usefini.com/#organization\",\"name\":\"Fini\",\"url\":\"https://docs.usefini.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fini/fep-JMymNphpe1DQ/images/shared/logos/fini-light.png?fit=max\u0026auto=format\u0026n=fep-JMymNphpe1DQ\u0026q=85\u0026s=a460ff8bb507876712db2f0fb12c21e4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usefini.com#website\",\"name\":\"Fini\",\"url\":\"https://docs.usefini.com\",\"publisher\":{\"@id\":\"https://docs.usefini.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usefini.com/en/api-reference/generate-knowledge#webpage\",\"url\":\"https://docs.usefini.com/en/api-reference/generate-knowledge\",\"name\":\"Generate knowledge\",\"description\":\"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\",\"dateModified\":\"2026-10-05T17:02:06.970Z\",\"isPartOf\":{\"@id\":\"https://docs.usefini.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usefini.com/en/api-reference/generate-knowledge#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usefini.com/en/api-reference/generate-knowledge#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Knowledge\",\"item\":\"https://docs.usefini.com/en/api-reference/sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Knowledge generation\",\"item\":\"https://docs.usefini.com/en/api-reference/knowledge\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Generate knowledge\",\"item\":\"https://docs.usefini.com/en/api-reference/generate-knowledge\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usefini.com/en/api-reference/generate-knowledge#apireference\",\"headline\":\"Generate knowledge\",\"name\":\"Generate knowledge\",\"description\":\"Queue one knowledge-generation job from candidate text, with optional source or inbox linkage.\",\"url\":\"https://docs.usefini.com/en/api-reference/generate-knowledge\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usefini.com/en/api-reference/generate-knowledge#webpage\"},\"dateModified\":\"2026-10-05T17:02:06.970Z\",\"publisher\":{\"@id\":\"https://docs.usefini.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usefini.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fini\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fini","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/introduction"}]},{"tab":"API reference","pages":[{"group":"API Setup","icon":"sliders","pages":[{"title":"API overview","icon":"code-branch","href":"/en/api-reference/overview"},{"title":"API contract","icon":"code","href":"/en/api-reference/api-contract"},{"title":"Static IP Addresses","icon":"address-book","href":"/en/api-reference/static-ip"},{"title":"Database and Warehouse Connections","icon":"database","href":"/en/api-reference/database-warehouses"},{"title":"MCP Connections","icon":"plug","href":"/en/api-reference/connect-mcp"}]},{"group":"LLM Access","icon":"acorn","pages":[{"title":"Coding agents","icon":"robot","href":"/en/api-reference/coding-agents"},{"title":"Claude Plugin","icon":"puzzle-piece","href":"/en/api-reference/claude-connector"}]},{"group":"Agents","public":true,"icon":"robot","pages":[{"title":"Overview","icon":"robot","href":"/en/api-reference/agents"},{"title":"Create agent","api":"POST https://api-prod.usefini.com/v2/bots/public","href":"/en/api-reference/create-agent"},{"title":"List agents","api":"GET https://api-prod.usefini.com/v2/bots/public","href":"/en/api-reference/list-agents"},{"title":"Delete agent","api":"DELETE https://api-prod.usefini.com/v2/bots/{id}/public","href":"/en/api-reference/delete-agent"}]},{"group":"Analytics","public":true,"icon":"chart-line","pages":[{"title":"Overview","icon":"chart-line","href":"/en/api-reference/analytics"},{"title":"Get agent analytics","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-analytics/public","href":"/en/api-reference/get-agent-analytics"},{"title":"Get agent analytics section","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-analytics/{section}/public","href":"/en/api-reference/get-agent-analytics-section"}]},{"group":"Help Centers","public":true,"icon":"book-open","pages":[{"title":"Overview","icon":"book-open","href":"/en/api-reference/help-centers"},{"title":"List help centers","api":"GET https://api-prod.usefini.com/v2/helpcenter/list/public","href":"/en/api-reference/list-help-centers"},{"title":"Get help center analytics","api":"GET https://api-prod.usefini.com/v2/helpcenter/{id}/analytics/public","href":"/en/api-reference/get-help-center-analytics"},{"title":"Export help center analytics","api":"GET https://api-prod.usefini.com/v2/helpcenter/{id}/analytics/export/public","href":"/en/api-reference/export-help-center-analytics"}]},{"group":"Profile","public":true,"icon":"user","pages":[{"title":"Overview","icon":"user","href":"/en/api-reference/profile"},{"title":"Update my reply alias","api":"PATCH https://api-prod.usefini.com/v2/users/me/public","href":"/en/api-reference/update-my-profile"}]},{"group":"Macros","public":true,"icon":"message","pages":[{"title":"Overview","icon":"message","href":"/en/api-reference/macros"},{"title":"List macros","api":"GET https://api-prod.usefini.com/v2/macros/public","href":"/en/api-reference/list-macros"},{"title":"Get macro","api":"GET https://api-prod.usefini.com/v2/macros/{id}/public","href":"/en/api-reference/get-macro"},{"title":"Create macro","api":"POST https://api-prod.usefini.com/v2/macros/public","href":"/en/api-reference/create-macro"},{"title":"Update macro","api":"PATCH https://api-prod.usefini.com/v2/macros/{id}/public","href":"/en/api-reference/update-macro"},{"title":"Delete macro","api":"DELETE https://api-prod.usefini.com/v2/macros/{id}/public","href":"/en/api-reference/delete-macro"}]},{"group":"Prompts","public":true,"icon":"message","pages":[{"title":"Overview","icon":"message","href":"/en/api-reference/prompts"},{"title":"Get prompts","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/public","href":"/en/api-reference/get-prompts"},{"title":"Get prompt history","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/history/public","href":"/en/api-reference/get-prompt-history"},{"title":"Get prompt version","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/{promptId}/public","href":"/en/api-reference/get-prompt-version"},{"title":"Update prompts","api":"POST https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/public","href":"/en/api-reference/update-prompts"},{"title":"Create prompt draft version","api":"POST https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/public","href":"/en/api-reference/create-prompt-draft-version"},{"title":"Get prompt draft version","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/{versionId}/public","href":"/en/api-reference/get-prompt-draft-version"},{"title":"Publish prompt draft version","api":"POST https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/{versionId}/publish/public","href":"/en/api-reference/publish-prompt-draft-version"},{"title":"Delete prompt draft version","api":"DELETE https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/{versionId}/public","href":"/en/api-reference/delete-prompt-draft-version"},{"title":"List prompt lifecycle versions","api":"GET https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/public","href":"/en/api-reference/list-prompt-versions"},{"title":"Restore prompt version as draft","api":"POST https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/versions/{versionId}/restore-as-draft/public","href":"/en/api-reference/restore-prompt-version-as-draft"}]},{"group":"Actions","public":true,"icon":"wand-magic-sparkles","pages":[{"title":"Overview","icon":"wand-magic-sparkles","href":"/en/api-reference/actions"},{"title":"List actions","api":"GET https://api-prod.usefini.com/v2/hc-tools/public","href":"/en/api-reference/list-actions"},{"title":"Get action","api":"GET https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/get-action"},{"title":"Create action","api":"POST https://api-prod.usefini.com/v2/hc-tools/public","href":"/en/api-reference/create-action"},{"title":"Update action","api":"PATCH https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/update-action"},{"title":"Delete action","api":"DELETE https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/delete-action"},{"title":"Test action","api":"POST https://api-prod.usefini.com/v2/hc-tools/{id}/test-run/public","href":"/en/api-reference/test-action"},{"title":"List agent assignments","api":"GET https://api-prod.usefini.com/v2/hc-tools/{id}/junctions/public","href":"/en/api-reference/list-action-agents"},{"title":"Assign to agents","api":"POST https://api-prod.usefini.com/v2/hc-tools/junctions/public","href":"/en/api-reference/assign-action-agents"}]},{"group":"Attributes","public":true,"icon":"id-card","pages":[{"title":"Overview","icon":"id-card","href":"/en/api-reference/attributes"},{"title":"List attributes","api":"GET https://api-prod.usefini.com/v2/hc-tools/public","href":"/en/api-reference/list-attributes"},{"title":"Get attribute","api":"GET https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/get-attribute"},{"title":"Create attribute","api":"POST https://api-prod.usefini.com/v2/hc-tools/public","href":"/en/api-reference/create-attribute"},{"title":"Update attribute","api":"PATCH https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/update-attribute"},{"title":"Delete attribute","api":"DELETE https://api-prod.usefini.com/v2/hc-tools/{id}/public","href":"/en/api-reference/delete-attribute"},{"title":"Test attribute","api":"POST https://api-prod.usefini.com/v2/hc-tools/{id}/test-run/public","href":"/en/api-reference/test-attribute"},{"title":"List agent assignments","api":"GET https://api-prod.usefini.com/v2/hc-tools/{id}/junctions/public","href":"/en/api-reference/list-attribute-agents"},{"title":"Assign to agents","api":"POST https://api-prod.usefini.com/v2/hc-tools/junctions/public","href":"/en/api-reference/assign-attribute-agents"}]},{"group":"External API calls","public":true,"icon":"plug","pages":[{"title":"Overview","icon":"plug","href":"/en/api-reference/actions-and-attributes"},{"title":"List external API calls","api":"GET https://api-prod.usefini.com/v2/api-function-configs/public","href":"/en/api-reference/list-data-steps"},{"title":"Get external API call","api":"GET https://api-prod.usefini.com/v2/api-function-configs/{id}/public","href":"/en/api-reference/get-data-step"},{"title":"Create external API call","api":"POST https://api-prod.usefini.com/v2/api-function-configs/public","href":"/en/api-reference/create-data-step"},{"title":"Update external API call","api":"PATCH https://api-prod.usefini.com/v2/api-function-configs/{id}/public","href":"/en/api-reference/update-data-step"},{"title":"Delete external API call","api":"DELETE https://api-prod.usefini.com/v2/api-function-configs/{id}/public","href":"/en/api-reference/delete-data-step"},{"title":"Test external API call","api":"POST https://api-prod.usefini.com/v2/api-function-configs/test-run/public","href":"/en/api-reference/test-data-step"}]},{"group":"Intent Rules","public":true,"icon":"route","pages":[{"title":"Overview","icon":"route","href":"/en/api-reference/intent-rules"},{"title":"List intent rules","api":"GET https://api-prod.usefini.com/v2/hc-rules/public","href":"/en/api-reference/list-intent-rules"},{"title":"Get intent rule","api":"GET https://api-prod.usefini.com/v2/hc-rules/{id}/public","href":"/en/api-reference/get-intent-rule"},{"title":"Get intent-rule fields context","api":"GET https://api-prod.usefini.com/v2/hc-rules/fields-context/public","href":"/en/api-reference/get-intent-rule-fields-context"},{"title":"Generate intent-rule draft with AI","api":"POST https://api-prod.usefini.com/v2/hc-rules/generate/public","href":"/en/api-reference/generate-intent-rule-draft"},{"title":"Create intent rule","api":"POST https://api-prod.usefini.com/v2/hc-rules/public","href":"/en/api-reference/create-intent-rule"},{"title":"Update intent rule","api":"PATCH https://api-prod.usefini.com/v2/hc-rules/{id}/public","href":"/en/api-reference/update-intent-rule"},{"title":"List intent-rule versions","api":"GET https://api-prod.usefini.com/v2/hc-rules/{id}/versions/public","href":"/en/api-reference/list-rule-versions"},{"title":"Get intent-rule version","api":"GET https://api-prod.usefini.com/v2/hc-rules/{id}/versions/{versionId}/public","href":"/en/api-reference/get-rule-version"},{"title":"Publish intent-rule draft","api":"POST https://api-prod.usefini.com/v2/hc-rules/{id}/publish/public","href":"/en/api-reference/publish-rule-draft"},{"title":"Unpublish intent rule","api":"POST https://api-prod.usefini.com/v2/hc-rules/{id}/unpublish/public","href":"/en/api-reference/unpublish-intent-rule"},{"title":"Restore intent-rule version as draft","api":"POST https://api-prod.usefini.com/v2/hc-rules/{id}/versions/{versionId}/restore-as-draft/public","href":"/en/api-reference/restore-rule-version-as-draft"},{"title":"Delete intent-rule draft version","api":"DELETE https://api-prod.usefini.com/v2/hc-rules/{id}/versions/{versionId}/public","href":"/en/api-reference/delete-rule-draft-version"},{"title":"Get rule version test paths","api":"GET https://api-prod.usefini.com/v2/hc-rules/{id}/versions/{versionId}/test-paths/public","href":"/en/api-reference/get-rule-version-test-paths"},{"title":"Preview rule test paths","api":"POST https://api-prod.usefini.com/v2/hc-rules/test-paths/config/public","href":"/en/api-reference/preview-rule-test-paths"},{"title":"Run rule version test path","api":"POST https://api-prod.usefini.com/v2/hc-rules/{id}/versions/{versionId}/test-paths/run/public","href":"/en/api-reference/run-rule-version-test-path"},{"title":"Run rule test path from config","api":"POST https://api-prod.usefini.com/v2/hc-rules/test-paths/config/run/public","href":"/en/api-reference/run-rule-test-path-config"},{"title":"Delete intent rule","api":"DELETE https://api-prod.usefini.com/v2/hc-rules/{id}/public","href":"/en/api-reference/delete-intent-rule"}]},{"group":"Guardrails","icon":"shield-check","pages":[{"title":"Overview","icon":"shield-check","href":"/en/api-reference/guardrails"},{"title":"List guardrail check types","api":"GET https://api-prod.usefini.com/v2/guardrail-policies/check-types/public","href":"/en/api-reference/list-guardrail-check-types"},{"title":"List guardrail policies","api":"GET https://api-prod.usefini.com/v2/guardrail-policies/public","href":"/en/api-reference/list-guardrail-policies"},{"title":"Get guardrail policy","api":"GET https://api-prod.usefini.com/v2/guardrail-policies/{id}/public","href":"/en/api-reference/get-guardrail-policy"},{"title":"Create guardrail policy","api":"POST https://api-prod.usefini.com/v2/guardrail-policies/public","href":"/en/api-reference/create-guardrail-policy"},{"title":"Update guardrail policy","api":"PUT https://api-prod.usefini.com/v2/guardrail-policies/{id}/public","href":"/en/api-reference/update-guardrail-policy"},{"title":"Delete guardrail policy","api":"DELETE https://api-prod.usefini.com/v2/guardrail-policies/{id}/public","href":"/en/api-reference/delete-guardrail-policy"},{"title":"List guardrail runs","api":"GET https://api-prod.usefini.com/v2/guardrail-policies/runs/public","href":"/en/api-reference/list-guardrail-runs"},{"title":"Get guardrail hits","api":"GET https://api-prod.usefini.com/v2/guardrail-policies/hits/public","href":"/en/api-reference/get-guardrail-hits"}]},{"group":"Business Rules","public":true,"icon":"briefcase","pages":[{"title":"Overview","icon":"briefcase","href":"/en/api-reference/business-rules"},{"title":"List Business Rules","api":"GET https://api-prod.usefini.com/v2/business-rules/public","href":"/en/api-reference/list-business-rules"},{"title":"Get Business Rule","api":"GET https://api-prod.usefini.com/v2/business-rules/{id}/public","href":"/en/api-reference/get-business-rule"},{"title":"Get Business Rule fields context","api":"GET https://api-prod.usefini.com/v2/business-rules/fields-context/public","href":"/en/api-reference/get-business-rule-fields-context"},{"title":"List default Business Rules","api":"GET https://api-prod.usefini.com/v2/business-rules/default/public","href":"/en/api-reference/list-default-rules"},{"title":"Create Business Rule","api":"POST https://api-prod.usefini.com/v2/business-rules/public","href":"/en/api-reference/create-business-rule"},{"title":"Duplicate Business Rule","api":"POST https://api-prod.usefini.com/v2/business-rules/{id}/duplicate/public","href":"/en/api-reference/duplicate-business-rule"},{"title":"Evaluate Business Rule","api":"POST https://api-prod.usefini.com/v2/business-rules/{id}/evaluate/public","href":"/en/api-reference/evaluate-business-rule"},{"title":"Get Business Rule test fields","api":"GET https://api-prod.usefini.com/v2/business-rules/{id}/test-fields/public","href":"/en/api-reference/get-business-rule-test-fields"},{"title":"Preview Business Rule test fields","api":"POST https://api-prod.usefini.com/v2/business-rules/test-fields/preview/public","href":"/en/api-reference/preview-business-rule-test-fields"},{"title":"Update Business Rule","api":"PATCH https://api-prod.usefini.com/v2/business-rules/{id}/public","href":"/en/api-reference/update-business-rule"},{"title":"Delete Business Rule","api":"DELETE https://api-prod.usefini.com/v2/business-rules/{id}/public","href":"/en/api-reference/delete-business-rule"}]},{"group":"Reply Rules","public":true,"icon":"reply-all","pages":[{"title":"Overview","icon":"reply-all","href":"/en/api-reference/reply-rules"},{"title":"Get reply rules","api":"GET https://api-prod.usefini.com/v2/reply-behavior/public","href":"/en/api-reference/get-reply-rules"},{"title":"Get reply rule fields context","api":"GET https://api-prod.usefini.com/v2/reply-behavior/fields-context/public","href":"/en/api-reference/get-reply-rule-fields-context"},{"title":"Update reply rule","api":"PUT https://api-prod.usefini.com/v2/reply-behavior/{replyType}/public","href":"/en/api-reference/update-reply-rule"}]},{"group":"Tag groups","public":true,"icon":"tag","pages":[{"title":"Overview","icon":"tag","href":"/en/api-reference/tag-groups"},{"title":"List tag groups","api":"GET https://api-prod.usefini.com/v2/tag-groups/public","href":"/en/api-reference/list-tag-groups"},{"title":"Get tag group","api":"GET https://api-prod.usefini.com/v2/tag-groups/{id}/public","href":"/en/api-reference/get-tag-group"},{"title":"Create tag group","api":"POST https://api-prod.usefini.com/v2/tag-groups/public","href":"/en/api-reference/create-tag-group"},{"title":"Update tag group","api":"PUT https://api-prod.usefini.com/v2/tag-groups/{id}/public","href":"/en/api-reference/update-tag-group"},{"title":"Delete tag group","api":"DELETE https://api-prod.usefini.com/v2/tag-groups/{id}/public","href":"/en/api-reference/delete-tag-group"}]},{"group":"Tags","public":true,"icon":"tag","pages":[{"title":"Overview","icon":"tag","href":"/en/api-reference/tags"},{"title":"Get tag","api":"GET https://api-prod.usefini.com/v2/tags/{id}/public","href":"/en/api-reference/get-tag"},{"title":"List tags in group","api":"GET https://api-prod.usefini.com/v2/tag-groups/{id}/tags/public","href":"/en/api-reference/list-tags-in-group"},{"title":"List tags across groups","api":"GET https://api-prod.usefini.com/v2/tag-groups/tags/public","href":"/en/api-reference/list-tags-across-groups"},{"title":"Create tag","api":"POST https://api-prod.usefini.com/v2/tag-groups/{id}/tags/public","href":"/en/api-reference/create-tag"},{"title":"Update tag","api":"PUT https://api-prod.usefini.com/v2/tag-groups/tags/{id}/public","href":"/en/api-reference/update-tag"},{"title":"Delete tag","api":"DELETE https://api-prod.usefini.com/v2/tag-groups/tags/{id}/public","href":"/en/api-reference/delete-tag"}]},{"group":"Conversations","public":true,"icon":"address-book","pages":[{"title":"Overview","icon":"address-book","href":"/en/api-reference/conversations"},{"title":"Sync conversations","api":"POST https://api-prod.usefini.com/v2/hc-interactions/sync/public","href":"/en/api-reference/sync-conversations"},{"title":"List conversations","api":"GET https://api-prod.usefini.com/v2/hc-interactions/public","href":"/en/api-reference/list-conversations"},{"title":"Get conversation","api":"GET https://api-prod.usefini.com/v2/hc-interactions/{id}/public","href":"/en/api-reference/get-conversation"},{"title":"Get conversation memories","api":"GET https://api-prod.usefini.com/v2/hc-interactions/{id}/memories/public","href":"/en/api-reference/get-conversation-memories"},{"title":"Get event metadata","api":"GET https://api-prod.usefini.com/v2/hc-events/{id}/metadata","href":"/en/api-reference/get-event-metadata"},{"title":"Generate Answer","api":"POST https://api-prod.usefini.com/v2/hc-interactions/events/public","href":"/en/api-reference/generate-answer"},{"title":"Send conversation feedback","api":"POST https://api-prod.usefini.com/v2/hc-interactions/{id}/feedback/public","href":"/en/api-reference/send-feedback-conversation"},{"title":"Mark feedback resolved","api":"POST https://api-prod.usefini.com/v2/hc-interactions/{id}/feedback-resolved/public","href":"/en/api-reference/resolve-conversation-feedback"},{"title":"Add feedback note","api":"POST https://api-prod.usefini.com/v2/hc-interactions/{id}/feedback-note/public","href":"/en/api-reference/add-conversation-feedback-note"},{"title":"Add internal note","api":"POST https://api-prod.usefini.com/v2/hc-interactions/{id}/internal-note/public","href":"/en/api-reference/add-conversation-internal-note"},{"title":"Evaluate conversation rule","api":"POST https://api-prod.usefini.com/v2/hc-interactions/{id}/evaluate-rule/{ruleId}/public","href":"/en/api-reference/evaluate-conversation-rule"},{"title":"Delete conversation","api":"DELETE https://api-prod.usefini.com/v2/hc-interactions/{id}/public","href":"/en/api-reference/delete-conversation"},{"title":"Bulk delete conversations","api":"DELETE https://api-prod.usefini.com/v2/hc-interactions/public","href":"/en/api-reference/bulk-delete-conversations"}]},{"group":"Refine with AI","public":true,"icon":"wand-magic-sparkles","pages":[{"title":"Overview","icon":"wand-magic-sparkles","href":"/en/api-reference/refine-with-ai"},{"title":"Create Refine with AI iteration","api":"POST https://api-prod.usefini.com/v2/fix-review/interactions/{id}/events/{eventId}/sessions/iterations/public","href":"/en/api-reference/create-fix-review-iteration"},{"title":"Get active Refine with AI session","api":"GET https://api-prod.usefini.com/v2/fix-review/interactions/{id}/events/{eventId}/session/public","href":"/en/api-reference/get-active-fix-review-session"},{"title":"Get Refine with AI session","api":"GET https://api-prod.usefini.com/v2/fix-review/interactions/{id}/events/{eventId}/sessions/{sessionId}/public","href":"/en/api-reference/get-fix-review-session"}]},{"group":"Replays","public":true,"icon":"arrow-rotate-right","pages":[{"title":"Replays","icon":"arrow-rotate-right","href":"/en/api-reference/replays"},{"title":"Create replay","api":"POST https://api-prod.usefini.com/v2/replays/public","href":"/en/api-reference/create-replay"},{"title":"List replays","api":"GET https://api-prod.usefini.com/v2/replays/interactions/{interactionId}/public","href":"/en/api-reference/list-replays"},{"title":"Get replay","api":"GET https://api-prod.usefini.com/v2/replays/{id}/public","href":"/en/api-reference/get-replay"},{"title":"Get replay events","api":"GET https://api-prod.usefini.com/v2/replays/{id}/events/public","href":"/en/api-reference/get-replay-events"}]},{"group":"Test Suite","public":true,"icon":"vial","pages":[{"title":"Overview","icon":"vial","href":"/en/api-reference/test-suite"},{"title":"List criteria groups","api":"GET https://api-prod.usefini.com/v2/test-suite/criteria-groups/public","href":"/en/api-reference/list-test-suite-criteria-groups"},{"title":"Create criteria group","api":"POST https://api-prod.usefini.com/v2/test-suite/criteria-groups/public","href":"/en/api-reference/create-test-suite-criteria-group"},{"title":"Get criteria group","api":"GET https://api-prod.usefini.com/v2/test-suite/criteria-groups/{id}/public","href":"/en/api-reference/get-test-suite-criteria-group"},{"title":"Update criteria group","api":"PATCH https://api-prod.usefini.com/v2/test-suite/criteria-groups/{id}/public","href":"/en/api-reference/update-test-suite-criteria-group"},{"title":"Add cases to criteria group","api":"POST https://api-prod.usefini.com/v2/test-suite/criteria-groups/{id}/cases/public","href":"/en/api-reference/add-test-suite-group-cases"},{"title":"Remove cases from criteria group","api":"DELETE https://api-prod.usefini.com/v2/test-suite/criteria-groups/{id}/cases/public","href":"/en/api-reference/remove-test-suite-group-cases"},{"title":"Add conversations to criteria group","api":"POST https://api-prod.usefini.com/v2/test-suite/criteria-groups/{id}/conversations/public","href":"/en/api-reference/add-test-suite-group-conversations"},{"title":"Get Test Suite fields context","api":"GET https://api-prod.usefini.com/v2/test-suite/fields-context/public","href":"/en/api-reference/get-test-suite-fields-context"},{"title":"Create library criterion","api":"POST https://api-prod.usefini.com/v2/test-suite/criteria/public","href":"/en/api-reference/create-test-suite-criterion"},{"title":"Get run configuration","api":"GET https://api-prod.usefini.com/v2/test-suite/run-configuration/public","href":"/en/api-reference/get-test-suite-run-configuration"},{"title":"List Action fixtures","api":"GET https://api-prod.usefini.com/v2/test-suite/action-fixtures/public","href":"/en/api-reference/list-test-suite-action-fixtures"},{"title":"List test cases","api":"GET https://api-prod.usefini.com/v2/test-suite/cases/public","href":"/en/api-reference/list-test-suite-cases"},{"title":"Get conversation input","api":"GET https://api-prod.usefini.com/v2/test-suite/conversation-input/public","href":"/en/api-reference/get-test-suite-conversation-input"},{"title":"Create test case","api":"POST https://api-prod.usefini.com/v2/test-suite/cases/public","href":"/en/api-reference/create-test-suite-case"},{"title":"Get test case","api":"GET https://api-prod.usefini.com/v2/test-suite/cases/{id}/public","href":"/en/api-reference/get-test-suite-case"},{"title":"Update test case","api":"PATCH https://api-prod.usefini.com/v2/test-suite/cases/{id}/public","href":"/en/api-reference/update-test-suite-case"},{"title":"Delete test case","api":"DELETE https://api-prod.usefini.com/v2/test-suite/cases/{id}/public","href":"/en/api-reference/delete-test-suite-case"},{"title":"List collections","api":"GET https://api-prod.usefini.com/v2/test-suite/folders/public","href":"/en/api-reference/list-test-suite-collections"},{"title":"Create collection","api":"POST https://api-prod.usefini.com/v2/test-suite/folders/public","href":"/en/api-reference/create-test-suite-collection"},{"title":"Delete collection","api":"DELETE https://api-prod.usefini.com/v2/test-suite/folders/{id}/public","href":"/en/api-reference/delete-test-suite-collection"},{"title":"Add cases to collection","api":"POST https://api-prod.usefini.com/v2/test-suite/folders/{id}/cases/public","href":"/en/api-reference/add-test-suite-collection-cases"},{"title":"Add criteria groups to collection","api":"POST https://api-prod.usefini.com/v2/test-suite/folders/{id}/groups/public","href":"/en/api-reference/add-test-suite-collection-groups"},{"title":"Remove cases from collection","api":"DELETE https://api-prod.usefini.com/v2/test-suite/folders/{id}/cases/public","href":"/en/api-reference/remove-test-suite-collection-cases"},{"title":"Remove criteria groups from collection","api":"DELETE https://api-prod.usefini.com/v2/test-suite/folders/{id}/groups/public","href":"/en/api-reference/remove-test-suite-collection-groups"},{"title":"List runs","api":"GET https://api-prod.usefini.com/v2/test-suite/runs/public","href":"/en/api-reference/list-test-suite-runs"},{"title":"Get Test Suite summary","api":"GET https://api-prod.usefini.com/v2/test-suite/summary/public","href":"/en/api-reference/get-test-suite-summary"},{"title":"Preview run readiness","api":"POST https://api-prod.usefini.com/v2/test-suite/runs/preview/public","href":"/en/api-reference/preview-test-suite-run"},{"title":"Start run","api":"POST https://api-prod.usefini.com/v2/test-suite/runs/public","href":"/en/api-reference/start-test-suite-run"},{"title":"Get run","api":"GET https://api-prod.usefini.com/v2/test-suite/runs/{id}/public","href":"/en/api-reference/get-test-suite-run"},{"title":"Save missing Action mock","api":"POST https://api-prod.usefini.com/v2/test-suite/case-runs/{id}/action-mocks/public","href":"/en/api-reference/save-test-suite-missing-action-mock"}]},{"group":"Knowledge","public":true,"icon":"hexagon-nodes","pages":[{"group":"Sources","icon":"book-open","pages":[{"title":"Overview","icon":"book-open","href":"/en/api-reference/sources"},{"title":"List sources","api":"GET https://api-prod.usefini.com/v2/documents/public","href":"/en/api-reference/list-sources"},{"title":"Get source","api":"GET https://api-prod.usefini.com/v2/documents/public/{id}","href":"/en/api-reference/get-source"},{"title":"List provider resources","api":"GET https://api-prod.usefini.com/v2/documents/public/resources/{provider}","href":"/en/api-reference/list-provider-resources"},{"title":"Register provider resources","api":"POST https://api-prod.usefini.com/v2/documents/public/resources/{provider}","href":"/en/api-reference/register-provider-resources"},{"title":"Ingest sources","api":"POST https://api-prod.usefini.com/v2/documents/public","href":"/en/api-reference/ingest-sources"},{"title":"Crawl links","api":"POST https://api-prod.usefini.com/v2/documents/public/deep-crawl/links","href":"/en/api-reference/deep-crawl-links"},{"title":"Refresh sources","api":"POST https://api-prod.usefini.com/v2/documents/public/refresh","href":"/en/api-reference/refresh-sources"},{"title":"Delete sources","api":"DELETE https://api-prod.usefini.com/v2/documents/public","href":"/en/api-reference/delete-sources"}]},{"group":"Knowledge generation","icon":"wand-magic-sparkles","pages":[{"title":"Overview","icon":"wand-magic-sparkles","href":"/en/api-reference/knowledge"},{"title":"Initialize knowledge folders","api":"POST https://api-prod.usefini.com/v2/knowledge/public/tree/initialize","href":"/en/api-reference/initialize-knowledge-folders"},{"title":"Persist knowledge folders","api":"POST https://api-prod.usefini.com/v2/knowledge/public/tree/persist","description":"Upload a tree file and persist it into the workspace knowledge graph.","href":"/en/api-reference/persist-knowledge-folders"},{"title":"Generate knowledge","api":"POST https://api-prod.usefini.com/v2/knowledge/public","href":"/en/api-reference/generate-knowledge"},{"title":"Bulk generate knowledge","api":"POST https://api-prod.usefini.com/v2/knowledge/public/bulk","description":"Queue generate-and-save jobs for multiple source IDs in one request.","href":"/en/api-reference/bulk-generate-knowledge"},{"title":"Check knowledge jobs","api":"POST https://api-prod.usefini.com/v2/knowledge/public/jobs/status","href":"/en/api-reference/check-knowledge-jobs"}]},{"group":"Articles","icon":"book-open","pages":[{"title":"Overview","icon":"book-open","href":"/en/api-reference/manage-knowledge"},{"title":"List articles","api":"GET https://api-prod.usefini.com/v2/hc-articles/public","href":"/en/api-reference/list-articles"},{"title":"Get articles by IDs","api":"POST https://api-prod.usefini.com/v2/hc-articles/ids/public","href":"/en/api-reference/get-articles-by-ids"},{"title":"Create article","api":"POST https://api-prod.usefini.com/v2/hc-articles/public","href":"/en/api-reference/create-article"},{"title":"Update article","api":"PUT https://api-prod.usefini.com/v2/hc-articles/{id}/public","href":"/en/api-reference/update-article"},{"title":"Create article draft","api":"POST https://api-prod.usefini.com/v2/hc-articles/{id}/draft/public","href":"/en/api-reference/create-article-draft"},{"title":"Publish article draft","api":"POST https://api-prod.usefini.com/v2/hc-articles/{id}/publish/public","href":"/en/api-reference/publish-article-draft"},{"title":"List article history","api":"GET https://api-prod.usefini.com/v2/hc-articles/{id}/history/public","href":"/en/api-reference/list-article-history"},{"title":"Get article history version","api":"POST https://api-prod.usefini.com/v2/hc-articles/{id}/history/public","href":"/en/api-reference/get-article-history-version"},{"title":"Revert article version","api":"POST https://api-prod.usefini.com/v2/hc-articles/{id}/revert/public","href":"/en/api-reference/revert-article-version"},{"title":"Delete article","api":"DELETE https://api-prod.usefini.com/v2/hc-articles/{id}/public","href":"/en/api-reference/delete-article"}]},{"group":"Folders \u0026 assignments","icon":"folder","pages":[{"title":"Overview","icon":"folder","href":"/en/api-reference/organize-knowledge"},{"title":"Get knowledge folders","api":"GET https://api-prod.usefini.com/v2/hc-folders/public","href":"/en/api-reference/get-knowledge-folders"},{"title":"Create knowledge folder","api":"POST https://api-prod.usefini.com/v2/hc-folders/public","href":"/en/api-reference/create-knowledge-folder"},{"title":"Update knowledge folder","api":"PUT https://api-prod.usefini.com/v2/hc-folders/{id}/public","href":"/en/api-reference/update-knowledge-folder"},{"title":"Move knowledge folder","api":"PUT https://api-prod.usefini.com/v2/hc-folders/{id}/move/public","href":"/en/api-reference/move-knowledge-folder"},{"title":"Move article","api":"PUT https://api-prod.usefini.com/v2/hc-articles/{id}/move/public","href":"/en/api-reference/move-article"},{"title":"Delete knowledge folder","api":"DELETE https://api-prod.usefini.com/v2/hc-folders/{id}/public","href":"/en/api-reference/delete-knowledge-folder"},{"title":"Assign knowledge to agents","api":"POST https://api-prod.usefini.com/v2/hc-bot-folder-junctions/public","href":"/en/api-reference/assign-knowledge-to-agents"}]}]},{"group":"Updates","icon":"clock-rotate-left","pages":[{"title":"Changelog","icon":"clock-rotate-left","href":"/en/changelog"}]}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/en/use-cases/refunds"}]},{"tab":"Trust \u0026 pricing","pages":[{"title":"Trust \u0026 pricing","href":"/en/security/overview"}]}]}]},"basePath":"","title":"Generate knowledge - Fini","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js"]}