curl --request POST \ --url 'https://api-prod.usefini.com/v2/hc-articles/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "title": "Canceling your subscription", "mainKnowledge": "Customers can cancel from Billing in the dashboard.", "agentInstruction": "Use this only for self-serve web plans.", "questions": ["How do I cancel?", "Can I end my plan today?"], "keywords": ["cancel", "subscription", "billing"], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "origin": "API_CREATED" }'
const response = await fetch('https://api-prod.usefini.com/v2/hc-articles/public', { method: 'POST', headers: { Authorization: 'Bearer fini_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ 'title': 'Refund policy', 'mainKnowledge': 'Customers can request a refund within 30 days of purchase.', 'agentInstruction': '2a1cf0f0-f35d-46ad-8e61-a15c86b2b312', 'questions': [ 'How do refunds work?' ], 'keywords': [ 'refund' ], 'escalation': true, 'parentFolderId': '0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b', 'isDraft': false, 'origin': 'API_CREATED'} )});const data = await response.json();
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/hc-articles/public", headers={"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"}, json={ "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312", "questions": [ "How do refunds work?" ], "keywords": [ "refund" ], "escalation": True, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": False, "origin": "API_CREATED"},)data = response.json()
{ "id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "Use this article for refund eligibility questions.", "questions": [ "Can I get a refund?" ], "keywords": [ "refund", "billing" ], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": false, "createdBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "updatedBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "origin": "API_CREATED", "createdAt": "2026-07-28T08:55:32.000Z", "updatedAt": "2026-07-28T09:10:18.000Z"}
Articles
Create article
Create a live article or draft article directly in the workspace.
POST
/
v2
/
hc-articles
/
public
curl --request POST \ --url 'https://api-prod.usefini.com/v2/hc-articles/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "title": "Canceling your subscription", "mainKnowledge": "Customers can cancel from Billing in the dashboard.", "agentInstruction": "Use this only for self-serve web plans.", "questions": ["How do I cancel?", "Can I end my plan today?"], "keywords": ["cancel", "subscription", "billing"], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "origin": "API_CREATED" }'
const response = await fetch('https://api-prod.usefini.com/v2/hc-articles/public', { method: 'POST', headers: { Authorization: 'Bearer fini_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ 'title': 'Refund policy', 'mainKnowledge': 'Customers can request a refund within 30 days of purchase.', 'agentInstruction': '2a1cf0f0-f35d-46ad-8e61-a15c86b2b312', 'questions': [ 'How do refunds work?' ], 'keywords': [ 'refund' ], 'escalation': true, 'parentFolderId': '0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b', 'isDraft': false, 'origin': 'API_CREATED'} )});const data = await response.json();
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/hc-articles/public", headers={"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"}, json={ "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312", "questions": [ "How do refunds work?" ], "keywords": [ "refund" ], "escalation": True, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": False, "origin": "API_CREATED"},)data = response.json()
{ "id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "Use this article for refund eligibility questions.", "questions": [ "Can I get a refund?" ], "keywords": [ "refund", "billing" ], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": false, "createdBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "updatedBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "origin": "API_CREATED", "createdAt": "2026-07-28T08:55:32.000Z", "updatedAt": "2026-07-28T09:10:18.000Z"}
Use this route when you want to write articles directly instead of generating them from sources.
Optional public authoring origin. Allowed values are API_CREATED and FINI_SCOUT. If omitted, API-key and OAuth requests default to API_CREATED.
POST /v2/hc-articles/public only uses the fields documented above. Even though the internal DTO also permits active, public, and originalArticleId, the public create controller does not pass them through.
curl --request POST \ --url 'https://api-prod.usefini.com/v2/hc-articles/public' \ --header 'Authorization: Bearer fini_your_api_key' \ --header 'Content-Type: application/json' \ --data '{ "title": "Canceling your subscription", "mainKnowledge": "Customers can cancel from Billing in the dashboard.", "agentInstruction": "Use this only for self-serve web plans.", "questions": ["How do I cancel?", "Can I end my plan today?"], "keywords": ["cancel", "subscription", "billing"], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "origin": "API_CREATED" }'
const response = await fetch('https://api-prod.usefini.com/v2/hc-articles/public', { method: 'POST', headers: { Authorization: 'Bearer fini_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ 'title': 'Refund policy', 'mainKnowledge': 'Customers can request a refund within 30 days of purchase.', 'agentInstruction': '2a1cf0f0-f35d-46ad-8e61-a15c86b2b312', 'questions': [ 'How do refunds work?' ], 'keywords': [ 'refund' ], 'escalation': true, 'parentFolderId': '0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b', 'isDraft': false, 'origin': 'API_CREATED'} )});const data = await response.json();
import requestsresponse = requests.post( "https://api-prod.usefini.com/v2/hc-articles/public", headers={"Authorization": "Bearer fini_your_api_key", "Content-Type": "application/json"}, json={ "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312", "questions": [ "How do refunds work?" ], "keywords": [ "refund" ], "escalation": True, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": False, "origin": "API_CREATED"},)data = response.json()
{ "id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3", "title": "Refund policy", "mainKnowledge": "Customers can request a refund within 30 days of purchase.", "agentInstruction": "Use this article for refund eligibility questions.", "questions": [ "Can I get a refund?" ], "keywords": [ "refund", "billing" ], "escalation": false, "parentFolderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b", "isDraft": false, "createdBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "updatedBy": "7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67", "origin": "API_CREATED", "createdAt": "2026-07-28T08:55:32.000Z", "updatedAt": "2026-07-28T09:10:18.000Z"}
Returns the created article object. See Manage knowledge for the shared article fields.
Because the public create route does not expose active or public, newly created articles currently come back with the service defaults for those fields.
The request body is malformed or one of the required arrays is empty.
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
The API key does not include the write scope.
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.4067","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":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/create-article","slug":"/en/api-reference/create-article","pageMetadata":{"title":"Create article","api":"POST https://api-prod.usefini.com/v2/hc-articles/public","description":"Create a live article or draft article directly in the workspace.","href":"/en/api-reference/create-article"},"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: \"Create a live article or draft article directly in the workspace.\"\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`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Heading,Note,ParamField}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use this route when you want to write articles directly instead of generating them from sources.`}),`\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:`title`,type:`string`,required:true,id:`param-title`,children:_jsx(_components.p,{children:`Article title.`})}),`\n`,_jsx(ParamField,{body:`mainKnowledge`,type:`string`,required:true,id:`param-main-knowledge`,children:_jsx(_components.p,{children:`Main knowledge body.`})}),`\n`,_jsx(ParamField,{body:`agentInstruction`,type:`string`,required:true,id:`param-agent-instruction`,children:_jsx(_components.p,{children:`Instructions the agent should apply when using this article.`})}),`\n`,_jsx(ParamField,{body:`questions`,type:`array`,required:true,id:`param-questions`,children:_jsx(_components.p,{children:`Related questions for the article.`})}),`\n`,_jsx(ParamField,{body:`keywords`,type:`array`,required:true,id:`param-keywords`,children:_jsx(_components.p,{children:`Keywords for the article.`})}),`\n`,_jsx(ParamField,{body:`escalation`,type:`boolean`,required:true,id:`param-escalation`,children:_jsx(_components.p,{children:`Whether the article is escalation-related.`})}),`\n`,_jsx(ParamField,{body:`parentFolderId`,type:`string`,required:true,id:`param-parent-folder-id`,children:_jsx(_components.p,{children:`Folder that should contain the article.`})}),`\n`,_jsx(ParamField,{body:`isDraft`,type:`boolean`,default:false,id:`param-is-draft`,children:_jsx(_components.p,{children:`Whether to create the article as a draft instead of a live article.`})}),`\n`,_jsx(ParamField,{body:`origin`,type:`string`,id:`param-origin`,children:_jsxs(_components.p,{children:[`Optional public authoring origin. Allowed values are `,_jsx(_components.code,{children:`API_CREATED`}),` and `,_jsx(_components.code,{children:`FINI_SCOUT`}),`. If omitted, API-key and OAuth requests default to `,_jsx(_components.code,{children:`API_CREATED`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v2/hc-articles/public`}),` only uses the fields documented above. Even though the internal DTO also permits `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`public`}),`, and `,_jsx(_components.code,{children:`originalArticleId`}),`, the public create controller does not pass them through.`]})}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns the created article object. See `,_jsx(_components.a,{href:`/en/api-reference/manage-knowledge`,children:`Manage knowledge`}),` for the shared article fields.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Because the public create route does not expose `,_jsx(_components.code,{children:`active`}),` or `,_jsx(_components.code,{children:`public`}),`, newly created articles currently come back with the service defaults for those fields.`]})}),`\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:_jsx(_components.p,{children:`The request body is malformed or one of the required arrays is empty.`})}),_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.`]})})]})]})}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":"Create article","api":"POST https://api-prod.usefini.com/v2/hc-articles/public","description":"Create a live article or draft article directly in the workspace.","href":"/en/api-reference/create-article"}}},"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`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Note,ParamField,RequestExample,ResponseExample}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use this route when you want to write articles directly instead of generating them from sources.`}),`\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:`title`,type:`string`,required:true,id:`param-title`,children:_jsx(_components.p,{children:`Article title.`})}),`\n`,_jsx(ParamField,{body:`mainKnowledge`,type:`string`,required:true,id:`param-main-knowledge`,children:_jsx(_components.p,{children:`Main knowledge body.`})}),`\n`,_jsx(ParamField,{body:`agentInstruction`,type:`string`,required:true,id:`param-agent-instruction`,children:_jsx(_components.p,{children:`Instructions the agent should apply when using this article.`})}),`\n`,_jsx(ParamField,{body:`questions`,type:`array`,required:true,id:`param-questions`,children:_jsx(_components.p,{children:`Related questions for the article.`})}),`\n`,_jsx(ParamField,{body:`keywords`,type:`array`,required:true,id:`param-keywords`,children:_jsx(_components.p,{children:`Keywords for the article.`})}),`\n`,_jsx(ParamField,{body:`escalation`,type:`boolean`,required:true,id:`param-escalation`,children:_jsx(_components.p,{children:`Whether the article is escalation-related.`})}),`\n`,_jsx(ParamField,{body:`parentFolderId`,type:`string`,required:true,id:`param-parent-folder-id`,children:_jsx(_components.p,{children:`Folder that should contain the article.`})}),`\n`,_jsx(ParamField,{body:`isDraft`,type:`boolean`,default:false,id:`param-is-draft`,children:_jsx(_components.p,{children:`Whether to create the article as a draft instead of a live article.`})}),`\n`,_jsx(ParamField,{body:`origin`,type:`string`,id:`param-origin`,children:_jsxs(_components.p,{children:[`Optional public authoring origin. Allowed values are `,_jsx(_components.code,{children:`API_CREATED`}),` and `,_jsx(_components.code,{children:`FINI_SCOUT`}),`. If omitted, API-key and OAuth requests default to `,_jsx(_components.code,{children:`API_CREATED`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v2/hc-articles/public`}),` only uses the fields documented above. Even though the internal DTO also permits `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`public`}),`, and `,_jsx(_components.code,{children:`originalArticleId`}),`, the public create controller does not pass them through.`]})}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`14`,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:`14`,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/hc-articles/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:` \"title\": \"Canceling your subscription\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mainKnowledge\": \"Customers can cancel from Billing in the dashboard.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentInstruction\": \"Use this only for self-serve web plans.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"questions\": [\"How do I cancel?\", \"Can I end my plan today?\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"keywords\": [\"cancel\", \"subscription\", \"billing\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"escalation\": false,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"parentFolderId\": \"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"origin\": \"API_CREATED\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`25`,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:`25`,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/hc-articles/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'`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'title'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Refund policy'`}),_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:` 'mainKnowledge'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Customers can request a refund within 30 days of purchase.'`}),_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:` 'agentInstruction'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2a1cf0f0-f35d-46ad-8e61-a15c86b2b312'`}),_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:` 'questions'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'How do refunds work?'`})}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'keywords'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'refund'`})}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'escalation'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`}),_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:` 'parentFolderId'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b'`}),_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\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` false`}),_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\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'API_CREATED'`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\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:` data`}),_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`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`23`,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:`23`,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/hc-articles/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:`{`}),_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:`, `}),_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`,_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:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Refund policy\"`}),_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:` \"mainKnowledge\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Customers can request a refund within 30 days of purchase.\"`}),_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:` \"agentInstruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2a1cf0f0-f35d-46ad-8e61-a15c86b2b312\"`}),_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:` \"questions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"How do refunds work?\"`})}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"keywords\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"refund\"`})}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"escalation\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"parentFolderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\"`}),_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:`False`}),_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:`\"API_CREATED\"`})]}),`\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`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`]})})})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`201 Created`,numberOfLines:`21`,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:`21`,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:` \"id\"`}),_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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Refund policy\"`}),_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:` \"mainKnowledge\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Customers can request a refund within 30 days of purchase.\"`}),_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:` \"agentInstruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Use this article for refund eligibility questions.\"`}),_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:` \"questions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Can I get a refund?\"`})}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"keywords\"`}),_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:` \"refund\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"billing\"`})}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"escalation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"parentFolderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\"`}),_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:` \"isDraft\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"createdBy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67\"`}),_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:` \"updatedBy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67\"`}),_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:` \"origin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"API_CREATED\"`}),_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:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-28T08:55:32.000Z\"`}),_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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-28T09:10:18.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns the created article object. See `,_jsx(_components.a,{href:`/en/api-reference/manage-knowledge`,children:`Manage knowledge`}),` for the shared article fields.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Because the public create route does not expose `,_jsx(_components.code,{children:`active`}),` or `,_jsx(_components.code,{children:`public`}),`, newly created articles currently come back with the service defaults for those fields.`]})}),`\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:_jsx(_components.p,{children:`The request body is malformed or one of the required arrays is empty.`})}),_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.`]})})]})]})}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":"Create article","api":"POST https://api-prod.usefini.com/v2/hc-articles/public","description":"Create a live article or draft article directly in the workspace.","href":"/en/api-reference/create-article"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","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=\"14\">\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/hc-articles/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\"> \"title\": \"Canceling your subscription\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mainKnowledge\": \"Customers can cancel from Billing in the dashboard.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agentInstruction\": \"Use this only for self-serve web plans.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"questions\": [\"How do I cancel?\", \"Can I end my plan today?\"],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"keywords\": [\"cancel\", \"subscription\", \"billing\"],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"escalation\": false,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"parentFolderId\": \"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"origin\": \"API_CREATED\"\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":"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=\"25\">\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/hc-articles/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>\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:#0A3069;--shiki-dark:#CE9178\"> 'title'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Refund policy'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'mainKnowledge'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Customers can request a refund within 30 days of purchase.'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'agentInstruction'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '2a1cf0f0-f35d-46ad-8e61-a15c86b2b312'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'questions'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'How do refunds work?'\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:#0A3069;--shiki-dark:#CE9178\"> 'keywords'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'refund'\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:#0A3069;--shiki-dark:#CE9178\"> 'escalation'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\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:#0A3069;--shiki-dark:#CE9178\"> 'parentFolderId'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b'\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:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> false\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:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'API_CREATED'\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\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> data\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>"},{"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=\"23\">\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/hc-articles/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>\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>\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:#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\"> \"title\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Refund policy\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mainKnowledge\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Customers can request a refund within 30 days of purchase.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agentInstruction\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2a1cf0f0-f35d-46ad-8e61-a15c86b2b312\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"questions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"How do refunds work?\"\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:#0A3069;--shiki-dark:#CE9178\"> \"keywords\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"refund\"\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:#0A3069;--shiki-dark:#CE9178\"> \"escalation\"\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:#0A3069;--shiki-dark:#CE9178\"> \"parentFolderId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\"\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\">False\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\">\"API_CREATED\"\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\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">data \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>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201 Created","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=\"21\">\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\"> \"id\"\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:#116329;--shiki-dark:#9CDCFE\"> \"title\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Refund policy\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"mainKnowledge\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Customers can request a refund within 30 days of purchase.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"agentInstruction\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Use this article for refund eligibility questions.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"questions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Can I get a refund?\"\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:#116329;--shiki-dark:#9CDCFE\"> \"keywords\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"refund\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"billing\"\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:#116329;--shiki-dark:#9CDCFE\"> \"escalation\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"parentFolderId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isDraft\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdBy\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updatedBy\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"7d8b62e3-0c36-4f3b-9988-6e6f4f1fbf67\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"origin\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"API_CREATED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-28T08:55:32.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updatedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-28T09:10:18.000Z\"\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":"Create article","path":"/v2/hc-articles/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":{"title":[{"type":"string","description":"Article title.","required":true}],"mainKnowledge":[{"type":"string","description":"Main knowledge body.","required":true}],"agentInstruction":[{"type":"string","description":"Instructions the agent should apply when using this article.","required":true}],"questions":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Related questions for the article.","required":true}],"keywords":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Keywords for the article.","required":true}],"escalation":[{"type":"boolean","description":"Whether the article is escalation-related.","required":true}],"parentFolderId":[{"type":"string","description":"Folder that should contain the article.","required":true}],"isDraft":[{"type":"boolean","description":"Whether to create the article as a draft instead of a live article."}],"origin":[{"type":"string","description":"Optional public authoring origin. Allowed values are `API_CREATED` and `FINI_SCOUT` . If omitted, API-key and OAuth requests default to `API_CREATED` ."}]}}],"examples":{"example":{"value":{"title":"\u003cstring>","mainKnowledge":"\u003cstring>","agentInstruction":"\u003cstring>","questions":[{}],"keywords":[{}],"escalation":true,"parentFolderId":"\u003cstring>","isDraft":true,"origin":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"fini","siteName":"Fini","title":"Create article - Fini","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/create-article","matchLevel":0}}},"lastModified":"2026-10-05T17:02:07.446Z","originalFileLocation":"en/api-reference/create-article.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=\"Create a live article or draft article directly in the workspace.\">\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=\"Create article - Fini\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a live article or draft article directly in the workspace.\">\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/create-article\">\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=Articles\u0026amp;title=Create+article\u0026amp;description=Create+a+live+article+or+draft+article+directly+in+the+workspace.\u0026amp;theme=f0910fa1b0920527ac15e186\u0026amp;signature=aa429ebe65589eb6d5b92f29360c47414f7d51dc6874184a28f34365ee1628ef\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create article - Fini\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a live article or draft article directly in the workspace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fini.mintlify.app/_mintlify/api/og/v2?division=Articles\u0026amp;title=Create+article\u0026amp;description=Create+a+live+article+or+draft+article+directly+in+the+workspace.\u0026amp;theme=f0910fa1b0920527ac15e186\u0026amp;signature=aa429ebe65589eb6d5b92f29360c47414f7d51dc6874184a28f34365ee1628ef\">\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/create-article\">\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/create-article.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/create-article#webpage\",\"url\":\"https://docs.usefini.com/en/api-reference/create-article\",\"name\":\"Create article\",\"description\":\"Create a live article or draft article directly in the workspace.\",\"dateModified\":\"2026-10-05T17:02:07.446Z\",\"isPartOf\":{\"@id\":\"https://docs.usefini.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usefini.com/en/api-reference/create-article#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usefini.com/en/api-reference/create-article#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Knowledge\",\"item\":\"https://docs.usefini.com/en/api-reference/sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Articles\",\"item\":\"https://docs.usefini.com/en/api-reference/manage-knowledge\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create article\",\"item\":\"https://docs.usefini.com/en/api-reference/create-article\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usefini.com/en/api-reference/create-article#apireference\",\"headline\":\"Create article\",\"name\":\"Create article\",\"description\":\"Create a live article or draft article directly in the workspace.\",\"url\":\"https://docs.usefini.com/en/api-reference/create-article\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usefini.com/en/api-reference/create-article#webpage\"},\"dateModified\":\"2026-10-05T17:02:07.446Z\",\"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","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","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","description":"Fetch one or more articles by ID.","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","description":"Update an existing article.","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":"Create article - Fini","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js"]}