{
"error": {
"code": "RATE_LIMITED",
"message": "Too many requests. Slow down and retry.",
"details": {
"retry_after": 21
}
},
"request_id": "req_01j9x4r2s3t4u5v6w7x8y9z0a1"
}
Content
Create article
Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand’s voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run.
If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another.
Articles started here appear in the project’s Agents section on a sheet named API.
Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused.
Limits: 10 calls per minute per key.
Needs: Agents. Your seat must be allowed to manage content.
Name of the content sheet the article row goes on, under Agents → Sheets. Default is the project's "API" sheet. A sheet holds 50 rows; a full one rolls over to "Name 2" and meta.sheet tells you where the row landed.
A unique id for this call. Also in the X-Request-Id header. Quote it when you contact support.
Example:
"req_01j9x4m2p7q8r9s0t1u2v3w4x5"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Radarkit","description":"Radarkit API and MCP server documentation.","colors":{"primary":"#e16540","light":"#e16540","dark":"#e16540"},"logo":{"light":"https://mintcdn.com/radarkitai/X9eylNrmylWzymb3/logo/radarkit.svg?fit=max\u0026auto=format\u0026n=X9eylNrmylWzymb3\u0026q=85\u0026s=1bd4f12891cefc0a28fdf68817b2b58e","dark":"https://mintcdn.com/radarkitai/X9eylNrmylWzymb3/logo/radarkit.svg?fit=max\u0026auto=format\u0026n=X9eylNrmylWzymb3\u0026q=85\u0026s=1bd4f12891cefc0a28fdf68817b2b58e","href":"https://radarkit.ai"},"favicon":"https://mintcdn.com/radarkitai/X9eylNrmylWzymb3/favicon.svg?fit=max\u0026auto=format\u0026n=X9eylNrmylWzymb3\u0026q=85\u0026s=31cd33a1a2fdc9a3510d34fd5b3ef4b9","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#ffffff","dark":"#ffffff"}},"navbar":{"links":[{"href":"https://radarkit.ai","label":"Website"},{"href":"https://radarkit.ai/login","label":"Log in"}],"primary":{"type":"button","label":"Get API key","href":"https://radarkit.ai/settings/api/keys"}},"footer":{"socials":{"x":"https://x.com/radarkitai","linkedin":"https://linkedin.com/company/radarkit","youtube":"https://www.youtube.com/@radarkit"},"links":[{"header":"Product","items":[{"label":"Dashboard","href":"https://radarkit.ai/dashboard"},{"label":"API keys","href":"https://radarkit.ai/settings/api/keys"},{"label":"Pricing","href":"https://radarkit.ai/pricing"}]}]},"seo":{"indexing":"all"},"fonts":{"family":"Inter"},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"radarkitai","hasAudioNarration":false,"actualSubdomain":"radarkitai","customDomains":["radarkit.ai"],"gitSource":{"type":"github","owner":"kingkross1","repo":"radarkit-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac4c6a0fbabb15cf73ebda9","collectionId":"08971453-da9d-4278-95d6-a4173900da5d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac4c6a0fbabb15cf73ebda9"},"entitlements":{},"buildId":"6ac4c6a0fbabb15cf73ebda9","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":31},{"language":"default","tag":"Overview","count":8},{"language":"default","tag":"Exports","count":5},{"language":"default","tag":"MCP Documentation","count":4},{"language":"default","tag":"Content","count":3},{"language":"default","tag":"Prompts","count":3},{"language":"default","tag":"Projects","count":2},{"language":"default","tag":"Responses","count":2},{"language":"default","tag":"Sources","count":2},{"language":"default","tag":"Topics","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".rk-cta{margin-top:1.5rem;padding:1.25rem;border:1px solid #f1e6e1;border-radius:14px;background:#fbfaf9}.rk-cta__logo{height:20px;width:auto;display:block;margin-bottom:.875rem}.rk-cta__title{margin:0 0 .375rem;font-size:.9375rem;font-weight:600;color:#1f2937}.rk-cta__text{margin:0 0 1rem;font-size:.8125rem;line-height:1.5;color:#6b7280}.rk-cta__buttons{display:flex;flex-direction:column;gap:.5rem}.rk-cta__btn{display:block;text-align:center;padding:.5rem .75rem;border-radius:9px;font-size:.8125rem;font-weight:500;text-decoration:none!important;transition:background-color 120ms ease,border-color 120ms ease}.rk-cta__btn--primary{background:#e16540;color:#fff!important}.rk-cta__btn--primary:hover{background:#d55a37}.rk-cta__btn--secondary{background:#fff;border:1px solid #e5e7eb;color:#374151!important}.rk-cta__btn--secondary:hover{border-color:#d1d5db}table code{white-space:nowrap}.rk-button{display:inline-flex;align-items:center;gap:.5rem;margin:.25rem 0 .5rem;padding:.55rem 1rem;border-radius:9px;background:#e16540;color:#fff!important;font-size:.875rem;font-weight:500;line-height:1.2;text-decoration:none!important;border:1px solid #e16540;transition:background-color 120ms ease}.rk-button:hover{background:#d55a37}.rk-button--secondary{background:#fff;border-color:#d1d5db;color:#374151!important}.rk-button--secondary:hover{background:#f9fafb}"}],"page":{"pagePath":"api-reference/content/create-article","slug":"/api-reference/content/create-article","pageMetadata":{"title":"Create article","description":"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand's voice. The draft lands in your editor. Writing takes a few minutes, so keep the run `id` and poll Get article run.\n\nIf an article for the same prompt, type and keyword is already being written or is done, you get that run back with `meta.reused: true` and no content credit is spent. Send `force: true` to write another.\n\nArticles started here appear in the project's Agents section on a sheet named API.\n\nCost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused.\n\nLimits: 10 calls per minute per key.\n\nNeeds: Agents. Your seat must be allowed to manage content.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/content/articles","href":"/api-reference/content/create-article","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand’s voice. The draft lands in your editor. Writing takes a few minutes, so keep the run \", _jsx(_components.code, {\n children: \"id\"\n }), \" and poll Get article run.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If an article for the same prompt, type and keyword is already being written or is done, you get that run back with \", _jsx(_components.code, {\n children: \"meta.reused: true\"\n }), \" and no content credit is spent. Send \", _jsx(_components.code, {\n children: \"force: true\"\n }), \" to write another.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Articles started here appear in the project’s Agents section on a sheet named API.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Limits: 10 calls per minute per key.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Needs: Agents. Your seat must be allowed to manage content.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create article","description":"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand's voice. The draft lands in your editor. Writing takes a few minutes, so keep the run `id` and poll Get article run.\n\nIf an article for the same prompt, type and keyword is already being written or is done, you get that run back with `meta.reused: true` and no content credit is spent. Send `force: true` to write another.\n\nArticles started here appear in the project's Agents section on a sheet named API.\n\nCost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused.\n\nLimits: 10 calls per minute per key.\n\nNeeds: Agents. Your seat must be allowed to manage content.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/content/articles","href":"/api-reference/content/create-article","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/radarkitai/1eb91493e5447143/cta.js"],"openApiReferenceData":{"operation":{"tags":["Content"],"operationId":"createArticle","summary":"Create article","description":"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand's voice. The draft lands in your editor. Writing takes a few minutes, so keep the run `id` and poll Get article run.\n\nIf an article for the same prompt, type and keyword is already being written or is done, you get that run back with `meta.reused: true` and no content credit is spent. Send `force: true` to write another.\n\nArticles started here appear in the project's Agents section on a sheet named API.\n\nCost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused.\n\nLimits: 10 calls per minute per key.\n\nNeeds: Agents. Your seat must be allowed to manage content.\n","parameters":["da02ad2b-4dc7-46ba-98bf-89023d42349e"],"requestBody":"e9baa858-28d9-4a88-b142-e7f19ec1498d","responses":{"202":"ad9a1030-c62a-4bbe-8500-f8d75001bee4","401":"31f05df7-3b83-441f-a9fe-58d686375022","402":"71d0c604-b505-4e01-a160-e346fba346b7","403":"0543ec4b-2d29-4717-9059-b8771d37de5d","404":"85632f3d-b674-45b0-8565-b20dfb7d07a1","422":"ca5eab8b-2f94-488d-86de-b6dbcd07149d","429":"c2cd49ee-e0b7-4db2-9464-13c6ec83fba0"},"method":"post","type":"path","servers":["ccc3f7c6-1e6f-48aa-b9eb-96d9108785ee"],"security":["c4747718-db8c-4ae8-9c79-a991edd99689"],"path":"/projects/{project}/content/articles","baseUrlOptions":["https://api.radarkit.ai/v1"],"title":"Create article","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"da02ad2b-4dc7-46ba-98bf-89023d42349e":{"name":"project","in":"path","required":true,"description":"The project id. 24 characters. From List projects.","schema":{"type":"string","pattern":"^[0-9a-f]{24}$","isRequired":true,"description":"The project id. 24 characters. From List projects.","uniqueKey":"","typeLabel":"string"},"example":"64f1a2b3c4d5e6f708192a3b"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt_id","keyword"],"properties":{"prompt_id":{"type":"integer","description":"The prompt the article targets.","isRequired":true,"uniqueKey":"prompt_id","typeLabel":"integer"},"keyword":{"type":"string","maxLength":255,"description":"The keyword the article should rank for, as in the Create Content dialog.","isRequired":true,"uniqueKey":"keyword","typeLabel":"string"},"article_type":{"type":"string","enum":["blog_post","listicle","comparison","alternatives","faq","first_person_review"],"description":"The article format. Default is the format the cited pages use most.","uniqueKey":"article_type","typeLabel":"enum\u003cstring>"},"country":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter country the article should rank in; drives the SERP research. Default is the project region.","uniqueKey":"country","typeLabel":"string"},"language":{"type":"string","enum":["en","da","de","es","fr","it","pt","nl","pl","ru"],"description":"Language of the SERP research and of the article. Default is English.","uniqueKey":"language","typeLabel":"enum\u003cstring>"},"additional_details":{"type":"string","maxLength":1500,"description":"Instructions for the writer.","uniqueKey":"additional_details","typeLabel":"string"},"force":{"type":"boolean","description":"Write a new article even if one for the same prompt, type and keyword exists.","uniqueKey":"force","typeLabel":"boolean"},"sheet":{"type":"string","maxLength":80,"description":"Name of the content sheet the article row goes on, under Agents → Sheets. Default is the project's \"API\" sheet. A sheet holds 50 rows; a full one rolls over to \"Name 2\" and `meta.sheet` tells you where the row landed.","uniqueKey":"sheet","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"prompt_id":2048,"article_type":"comparison","keyword":"best crm for startups","country":"US","language":"en","additional_details":"Lead with pricing. Mention the free tier for teams under 3."},"examples":{"Example":{"title":"Example","value":{"prompt_id":2048,"article_type":"comparison","keyword":"best crm for startups","country":"US","language":"en","additional_details":"Lead with pricing. Mention the free tier for teams under 3."}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ad9a1030-c62a-4bbe-8500-f8d75001bee4":{"description":"The run has started.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"data.id","typeLabel":"integer"},"project":{"type":"string","uniqueKey":"data.project","typeLabel":"string"},"status":{"type":"string","enum":["processing","completed","failed","cancelled"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"current_step":{"oneOf":[{"type":"string","uniqueKey":"data.current_step.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.current_step.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.current_step","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","uniqueKey":"data.error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.error","typeLabel":"string | null"},"retryable":{"type":"boolean","description":"True for failed and cancelled runs.","uniqueKey":"data.retryable","typeLabel":"boolean"},"prompt":{"type":"object","properties":{"id":{"oneOf":[{"type":"integer","uniqueKey":"data.prompt.id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.prompt.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.prompt.id","typeLabel":"integer | null"}},"uniqueKey":"data.prompt","typeLabel":"object"},"article":{"oneOf":[{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"data.article.oneOf.0.id","typeLabel":"integer"},"title":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.title","typeLabel":"string | null"},"keyword":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.keyword.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.keyword.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.keyword","typeLabel":"string | null"},"article_type":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.article_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.article_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.article_type","typeLabel":"string | null"},"write_mode":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.write_mode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.write_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.write_mode","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.status","typeLabel":"string | null"},"crawl_status":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.crawl_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.crawl_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.crawl_status","typeLabel":"string | null"},"outline_status":{"oneOf":[{"type":"string","uniqueKey":"data.article.oneOf.0.outline_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.article.oneOf.0.outline_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.outline_status","typeLabel":"string | null"},"word_count":{"oneOf":[{"type":"integer","uniqueKey":"data.article.oneOf.0.word_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.article.oneOf.0.word_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.word_count","typeLabel":"integer | null"},"scores":{"type":"object","properties":{"radarkit":{"oneOf":[{"type":"number","uniqueKey":"data.article.oneOf.0.scores.radarkit.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.article.oneOf.0.scores.radarkit.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.scores.radarkit","typeLabel":"number | null"},"seo":{"oneOf":[{"type":"number","uniqueKey":"data.article.oneOf.0.scores.seo.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.article.oneOf.0.scores.seo.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.scores.seo","typeLabel":"number | null"},"geo":{"oneOf":[{"type":"number","uniqueKey":"data.article.oneOf.0.scores.geo.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.article.oneOf.0.scores.geo.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.scores.geo","typeLabel":"number | null"},"readability":{"oneOf":[{"type":"number","uniqueKey":"data.article.oneOf.0.scores.readability.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.article.oneOf.0.scores.readability.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.scores.readability","typeLabel":"number | null"}},"uniqueKey":"data.article.oneOf.0.scores","typeLabel":"object"},"editor_url":{"oneOf":[{"type":"string","description":"Open this in the dashboard to edit and publish.","uniqueKey":"data.article.oneOf.0.editor_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Open this in the dashboard to edit and publish.","uniqueKey":"data.article.oneOf.0.editor_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.editor_url","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.article.oneOf.0.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.article.oneOf.0.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.article.oneOf.0.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.article.oneOf.0.updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.updated_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.article.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"integer"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"keyword":{"oneOf":[{"type":"string"},{"type":"null"}]},"article_type":{"oneOf":[{"type":"string"},{"type":"null"}]},"write_mode":{"oneOf":[{"type":"string"},{"type":"null"}]},"status":{"oneOf":[{"type":"string"},{"type":"null"}]},"crawl_status":{"oneOf":[{"type":"string"},{"type":"null"}]},"outline_status":{"oneOf":[{"type":"string"},{"type":"null"}]},"word_count":{"oneOf":[{"type":"integer"},{"type":"null"}]},"scores":{"type":"object","properties":{"radarkit":{"oneOf":[{"type":"number"},{"type":"null"}]},"seo":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo":{"oneOf":[{"type":"number"},{"type":"null"}]},"readability":{"oneOf":[{"type":"number"},{"type":"null"}]}}},"editor_url":{"oneOf":[{"type":"string","description":"Open this in the dashboard to edit and publish."},{"type":"null","description":"Open this in the dashboard to edit and publish."}]},"created_at":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"updated_at":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"uniqueKey":"data.article.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article","typeLabel":"object | null"},"started_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.started_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.completed_at","typeLabel":"string\u003cdate-time> | null"},"body_markdown":{"type":"string","description":"The article as Markdown. Only with `include=body`.","uniqueKey":"data.body_markdown","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"project":{"type":"string","uniqueKey":"meta.project","typeLabel":"string"},"reused":{"type":"boolean","description":"True when an existing run was returned instead of starting a new one.","uniqueKey":"meta.reused","typeLabel":"boolean"},"ai_content_credits_remaining":{"type":"integer","uniqueKey":"meta.ai_content_credits_remaining","typeLabel":"integer"},"next_step":{"type":"string","uniqueKey":"meta.next_step","typeLabel":"string"}},"uniqueKey":"meta","typeLabel":"object"},"credits":{"type":"object","description":"What this call cost and what is left. Also in the `X-RadarKit-Credits-Charged` and `X-RadarKit-Credits-Remaining` headers.","properties":{"charged":{"type":"integer","description":"API credits spent on this call.","uniqueKey":"credits.charged","typeLabel":"integer"},"remaining":{"oneOf":[{"type":"integer","description":"API credits left on the billed account. Null on free calls.","uniqueKey":"credits.remaining.oneOf.0","typeLabel":"integer"},{"type":"null","description":"API credits left on the billed account. Null on free calls.","uniqueKey":"credits.remaining.oneOf.1","typeLabel":"null"}],"uniqueKey":"credits.remaining","typeLabel":"integer | null"}},"uniqueKey":"credits","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"id":551,"project":"64f1a2b3c4d5e6f708192a3b","status":"processing","current_step":"creating","error":null,"retryable":false,"prompt":{"id":2048},"article":{"id":812,"title":null,"keyword":"best crm for startups","article_type":"comparison","write_mode":"ai","status":"draft","crawl_status":"pending","outline_status":"pending","word_count":null,"scores":{"radarkit":null,"seo":null,"geo":null,"readability":null},"editor_url":"https://radarkit.ai/dashboard/64f1a2b3c4d5e6f708192a3b/content/812","created_at":"2026-09-03T10:30:00+00:00","updated_at":"2026-09-03T10:30:00+00:00"},"started_at":"2026-09-03T10:30:00+00:00","completed_at":null},"meta":{"project":"64f1a2b3c4d5e6f708192a3b","reused":false,"ai_content_credits_remaining":19,"next_step":"Poll GET /v1/content/runs/{id} until status is completed, then open editor_url or fetch the body with include=body."},"credits":{"charged":1,"remaining":2941},"request_id":"req_01j9x519n0o1p2q3r4s5t6u7v8"},"examples":{"Example":{"title":"Example","value":{"data":{"id":551,"project":"64f1a2b3c4d5e6f708192a3b","status":"processing","current_step":"creating","error":null,"retryable":false,"prompt":{"id":2048},"article":{"id":812,"title":null,"keyword":"best crm for startups","article_type":"comparison","write_mode":"ai","status":"draft","crawl_status":"pending","outline_status":"pending","word_count":null,"scores":{"radarkit":null,"seo":null,"geo":null,"readability":null},"editor_url":"https://radarkit.ai/dashboard/64f1a2b3c4d5e6f708192a3b/content/812","created_at":"2026-09-03T10:30:00+00:00","updated_at":"2026-09-03T10:30:00+00:00"},"started_at":"2026-09-03T10:30:00+00:00","completed_at":null},"meta":{"project":"64f1a2b3c4d5e6f708192a3b","reused":false,"ai_content_credits_remaining":19,"next_step":"Poll GET /v1/content/runs/{id} until status is completed, then open editor_url or fetch the body with include=body."},"credits":{"charged":1,"remaining":2941},"request_id":"req_01j9x519n0o1p2q3r4s5t6u7v8"}}},"exampleType":"examples"}},"exampleType":"examples"},"31f05df7-3b83-441f-a9fe-58d686375022":{"description":"`UNAUTHENTICATED`: no key, a wrong key, or a revoked or expired key. `KEY_IN_QUERY` (400) if the key was in the URL.","content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"UNAUTHENTICATED","message":"Missing or invalid API key. Send it as: Authorization: Bearer rk_live_YOUR_KEY"},"request_id":"req_01j9x4q7z8y9x0w1v2u3t4s5r6"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHENTICATED","message":"Missing or invalid API key. Send it as: Authorization: Bearer rk_live_YOUR_KEY"},"request_id":"req_01j9x4q7z8y9x0w1v2u3t4s5r6"}}},"exampleType":"examples"}},"exampleType":"examples"},"71d0c604-b505-4e01-a160-e346fba346b7":{"description":"`INSUFFICIENT_CONTENT_CREDITS`: the owner has no AI content credits. `INSUFFICIENT_CREDITS`: no API credits left. `PLAN_INACTIVE` or `OWNER_PLAN_INACTIVE`: a plan is not active.","content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"request_id":"req_01j9x4m2p7q8r9s0t1u2v3w4x5"}}},"exampleType":"generated"}},"exampleType":"generated"},"0543ec4b-2d29-4717-9059-b8771d37de5d":{"description":"`SCOPE_MISSING`: the key has no Agents permission. `PROJECT_FORBIDDEN`: the key cannot reach this project. `PERMISSION_DENIED`: your seat cannot manage content.","content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"request_id":"req_01j9x4m2p7q8r9s0t1u2v3w4x5"}}},"exampleType":"generated"}},"exampleType":"generated"},"85632f3d-b674-45b0-8565-b20dfb7d07a1":{"description":"`PROJECT_NOT_FOUND`: no project with that id. `PROMPT_NOT_FOUND`: no active prompt with that id in this project.","content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"request_id":"req_01j9x4m2p7q8r9s0t1u2v3w4x5"}}},"exampleType":"generated"}},"exampleType":"generated"},"ca5eab8b-2f94-488d-86de-b6dbcd07149d":{"description":"`VALIDATION_FAILED`: a field is wrong, `details` says which. `CONTENT_REJECTED`: the Content agent refused the request, the message says why.","content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"request_id":"req_01j9x4m2p7q8r9s0t1u2v3w4x5"}}},"exampleType":"generated"}},"exampleType":"generated"},"c2cd49ee-e0b7-4db2-9464-13c6ec83fba0":{"description":"`RATE_LIMITED`: too many calls. Wait the seconds in `Retry-After` and send the same request again. Nothing was charged.","headers":{"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","description":"Every failed call has this shape and no `data`.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable. Build on this, not on the message.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For people. May change.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"object","uniqueKey":"error.details.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"More when there is more to say. Which field failed, how long to wait, which id already exists.","uniqueKey":"error.details.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"error.details","typeLabel":"object | object[]"}},"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"A unique id for this call. Also in the `X-Request-Id` header. Quote it when you contact support.","example":"req_01j9x4m2p7q8r9s0t1u2v3w4x5","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"RATE_LIMITED","message":"Too many requests. Slow down and retry.","details":{"retry_after":21}},"request_id":"req_01j9x4r2s3t4u5v6w7x8y9z0a1"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","message":"Too many requests. Slow down and retry.","details":{"retry_after":21}},"request_id":"req_01j9x4r2s3t4u5v6w7x8y9z0a1"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c4747718-db8c-4ae8-9c79-a991edd99689":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key. Create one in Settings, API keys. Send it as `Authorization: Bearer rk_live_YOUR_KEY`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"ccc3f7c6-1e6f-48aa-b9eb-96d9108785ee":{"url":"https://api.radarkit.ai/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key. Create one in Settings, API keys. Send it as `Authorization: Bearer rk_live_YOUR_KEY`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key. Create one in Settings, API keys. Send it as `Authorization: Bearer rk_live_YOUR_KEY`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"radarkitai","siteName":"Radarkit","title":"Create article - Radarkit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T10:00:06.460Z","originalFileLocation":"api-reference/content/create-article.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand\u0026#x27;s voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run. If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another. Articles started here appear in the project\u0026#x27;s Agents section on a sheet named API. Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused. Limits: 10 calls per minute per key. Needs: Agents. Your seat must be allowed to manage content.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Radarkit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create article - Radarkit\">\u003cmeta data-mint-head property=\"og:description\" content=\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand\u0026#x27;s voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run. If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another. Articles started here appear in the project\u0026#x27;s Agents section on a sheet named API. Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused. Limits: 10 calls per minute per key. Needs: Agents. Your seat must be allowed to manage content.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Radarkit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://radarkit.ai/docs/api-reference/content/create-article\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://radarkitai.mintlify.app/_mintlify/api/og/v2?division=Content\u0026amp;title=Create+article\u0026amp;description=Has+the+Content+agent+write+an+article+for+one+of+your+prompts.+The+agent+reads+the+pages+AI+models+cite+for+that+prompt%2C+builds+an+outline+and+writes+in+your+b\u0026amp;theme=28fdf1d2af466088c5a6e2ab\u0026amp;signature=a372d2f1ced710a7ea0ff7a2867e0603ef2607b9f59d5e4aaaecf4a13d0bc703\">\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 - Radarkit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand\u0026#x27;s voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run. If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another. Articles started here appear in the project\u0026#x27;s Agents section on a sheet named API. Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused. Limits: 10 calls per minute per key. Needs: Agents. Your seat must be allowed to manage content.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://radarkitai.mintlify.app/_mintlify/api/og/v2?division=Content\u0026amp;title=Create+article\u0026amp;description=Has+the+Content+agent+write+an+article+for+one+of+your+prompts.+The+agent+reads+the+pages+AI+models+cite+for+that+prompt%2C+builds+an+outline+and+writes+in+your+b\u0026amp;theme=28fdf1d2af466088c5a6e2ab\u0026amp;signature=a372d2f1ced710a7ea0ff7a2867e0603ef2607b9f59d5e4aaaecf4a13d0bc703\">\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=\"/docs/mintlify-assets/_mintlify/favicons/radarkitai/LxJReFld6yCVC2ma/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Radarkit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#e16540\">\u003clink data-mint-head rel=\"canonical\" href=\"https://radarkit.ai/docs/api-reference/content/create-article\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/content/create-article.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://radarkit.ai/#organization\",\"name\":\"Radarkit\",\"url\":\"https://radarkit.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/radarkitai/X9eylNrmylWzymb3/logo/radarkit.svg?fit=max\u0026auto=format\u0026n=X9eylNrmylWzymb3\u0026q=85\u0026s=1bd4f12891cefc0a28fdf68817b2b58e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://radarkit.ai/docs#website\",\"name\":\"Radarkit\",\"url\":\"https://radarkit.ai/docs\",\"publisher\":{\"@id\":\"https://radarkit.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://radarkit.ai/docs/api-reference/content/create-article#webpage\",\"url\":\"https://radarkit.ai/docs/api-reference/content/create-article\",\"name\":\"Create article\",\"description\":\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand's voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run. If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another. Articles started here appear in the project's Agents section on a sheet named API. Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused. Limits: 10 calls per minute per key. Needs: Agents. Your seat must be allowed to manage content.\",\"dateModified\":\"2026-10-06T10:00:06.460Z\",\"isPartOf\":{\"@id\":\"https://radarkit.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://radarkit.ai/docs/api-reference/content/create-article#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://radarkit.ai/docs/api-reference/content/create-article#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Radarkit\",\"item\":\"https://radarkit.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create article\",\"item\":\"https://radarkit.ai/docs/api-reference/content/create-article\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://radarkit.ai/docs/api-reference/content/create-article#apireference\",\"headline\":\"Create article\",\"name\":\"Create article\",\"description\":\"Has the Content agent write an article for one of your prompts. The agent reads the pages AI models cite for that prompt, builds an outline and writes in your brand's voice. The draft lands in your editor. Writing takes a few minutes, so keep the run id and poll Get article run. If an article for the same prompt, type and keyword is already being written or is done, you get that run back with meta.reused: true and no content credit is spent. Send force: true to write another. Articles started here appear in the project's Agents section on a sheet named API. Cost: 1 API credit plus 1 AI content credit from the project owner. Nothing is charged when the request is refused. Limits: 10 calls per minute per key. Needs: Agents. Your seat must be allowed to manage content.\",\"url\":\"https://radarkit.ai/docs/api-reference/content/create-article\",\"mainEntityOfPage\":{\"@id\":\"https://radarkit.ai/docs/api-reference/content/create-article#webpage\"},\"dateModified\":\"2026-10-06T10:00:06.460Z\",\"publisher\":{\"@id\":\"https://radarkit.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://radarkit.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Radarkit\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Radarkit","nav":{"global":null,"tabs":[{"tab":"API Documentation","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"Introduction","href":"/api/introduction"},{"title":"Authentication","href":"/api/authentication"},{"title":"Credits and rate limits","href":"/api/credits-and-limits"},{"title":"Errors","href":"/api/errors"}]},{"group":"Account","icon":"circle-user","pages":[{"title":"Get account","deprecated":null,"version":null,"openapi":"/openapi.yaml get /me","href":"/api-reference/account/get-account"}]},{"group":"Projects","icon":"folder-open","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects","href":"/api-reference/projects/list-projects"},{"title":"Get project","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}","href":"/api-reference/projects/get-project"}]},{"group":"Topics","icon":"tags","pages":[{"title":"List topics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/topics","href":"/api-reference/topics/list-topics"},{"title":"Add topic","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/topics","href":"/api-reference/topics/add-topic"}]},{"group":"Prompts","icon":"comments","pages":[{"title":"List prompts","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/prompts","href":"/api-reference/prompts/list-prompts"},{"title":"Add prompts","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/prompts","href":"/api-reference/prompts/add-prompts"},{"title":"Run a prompt now","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/prompts/{prompt}/run","href":"/api-reference/prompts/run-a-prompt-now"}]},{"group":"Visibility","icon":"chart-line","pages":[{"title":"Get visibility","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/visibility","href":"/api-reference/visibility/get-visibility"}]},{"group":"Responses","icon":"message-lines","pages":[{"title":"List responses","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/responses","href":"/api-reference/responses/list-responses"},{"title":"Get response","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/responses/{response}","href":"/api-reference/responses/get-response"}]},{"group":"Sources","icon":"link","pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/sources","href":"/api-reference/sources/list-sources"},{"title":"Top source domains","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/sources/top-domains","href":"/api-reference/sources/top-source-domains"}]},{"group":"Competitors","icon":"people-group","pages":[{"title":"Get share of voice","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/competitors","href":"/api-reference/competitors/get-share-of-voice"}]},{"group":"Rankings","icon":"ranking-star","pages":[{"title":"List rankings","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/rankings","href":"/api-reference/rankings/list-rankings"}]},{"group":"Query fanout","icon":"magnifying-glass","pages":[{"title":"List query fanout","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/query-fanout","href":"/api-reference/query-fanout/list-query-fanout"}]},{"group":"Web search","icon":"globe","pages":[{"title":"Get web search","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/web-search","href":"/api-reference/web-search/get-web-search"}]},{"group":"Sentiment","icon":"face-smile","pages":[{"title":"Get sentiment","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/sentiment","href":"/api-reference/sentiment/get-sentiment"}]},{"group":"Exports","icon":"file-arrow-down","pages":[{"title":"Estimate an export","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/exports/estimate","href":"/api-reference/exports/estimate-an-export"},{"title":"Create export","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/exports","href":"/api-reference/exports/create-export"},{"title":"List exports","deprecated":null,"version":null,"openapi":"/openapi.yaml get /projects/{project}/exports","href":"/api-reference/exports/list-exports"},{"title":"Get export","deprecated":null,"version":null,"openapi":"/openapi.yaml get /exports/{export}","href":"/api-reference/exports/get-export"},{"title":"Download export","description":"Sends you to the file. The answer is a `302` to a signed link that works for 30 minutes, so tell your HTTP client to follow redirects. With curl, pass `-L`. The file is gzip.\n\nCost: Free.\n\nNeeds: Read.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /exports/{export}/download","href":"/api-reference/exports/download-export"}]},{"group":"Content","icon":"feather","pages":[{"title":"Create article","deprecated":null,"version":null,"openapi":"/openapi.yaml post /projects/{project}/content/articles","href":"/api-reference/content/create-article"},{"title":"Get article run","description":"The status of one article run. Poll this every few seconds after Create article.\n\n`processing` is working and `current_step` says where it is. `completed` is done and the article has a title, a word count and scores. `failed` and `cancelled` say what happened and can be retried.\n\nAdd `include=body` once the run is completed to get the article as Markdown in `body_markdown`.\n\nCost: Free. 2 API credits with `include=body`.\n\nNeeds: Agents.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/runs/{run}","href":"/api-reference/content/get-article-run"},{"title":"Retry article run","deprecated":null,"version":null,"openapi":"/openapi.yaml post /content/runs/{run}/retry","href":"/api-reference/content/retry-article-run"}]},{"group":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"tab":"MCP Documentation","pages":[{"title":"MCP Documentation","href":"/mcp/introduction"}]}]},"title":"Create article - Radarkit","buildId":"dpl_BvXubCjoPYfvfFiCP5WgKvGYUZ9k","deploymentId":"dpl_BvXubCjoPYfvfFiCP5WgKvGYUZ9k","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Cn24bQ-L.js","utils-2fswSlDf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CCIi4ABW.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CAH7N_Ow.js","snippetPresets-x_0VpYAk.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-llGafAZf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-W1eCShSz.js","shallow-NLT_NnDI.js","getApiPlaygroundDisplay-QSEhtcdZ.js","CodeSnippet-CK8Lk0kg.js","CodeSnippets-Cra_whAm.js","Page-CQfXSH2v.js","getPastedJson-BEz4UfPL.js","icon-CwvrEduL.js","MethodPill-DblyOGAG.js","DuplicateIcon-7P7ixz4I.js","createIcon-BURR5_pt.js","DynamicMarkdown-DteaQut7.js","SectionHeading-CHtmkzk7.js","axios-vUo_bRtp.js","Markdown-BIU4AXHQ.js","clsx-Ds0AvV0Z.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Ka3QKbKd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BURaoZsB.js"]}