---
title: "/knowledgebase/articles/draft"
method: POST
path: "/knowledgebase/articles/draft"
tags: ["KnowledgeBase"]
---

# /knowledgebase/articles/draft

`POST /knowledgebase/articles/draft`

## Request

- Base URL: `<<api-url>>` (relative, and the document’s source URL is not known)
- URL: `<<api-url>>/knowledgebase/articles/draft`
- Auth: API key in header `X-API-KEY`

Create a new article draft in knowledgebase

## Headers

- `octa-agent-email` string

## Request body

- ArticlePayload
  - `culture` string: Culture/Language code
  - `title` string, required: Article title
  - `subtitle` string: Article subtitle
  - `url` string, required: Article URL (relative path)
  - `content` string, required: Article content in HTML format
  - `snippet` string: Article snippet/summary
  - `status` 'Unpublished' | 'PublishedWithChanges' | 'Published' | 'Draft' | 'Empty', required: Article status (will be forced to Draft)
  - `moduleId` string, required: Knowledgebase Module ID
  - `mainSection` string, required: Main section ID
  - `orderId` number: Article order ID
  - `categoryIds` string[], required: Category IDs
  - `sectionIds` string[], required: Section IDs
  - `editors` PersonDto[]: Article editors
    - `id` string, required: ID
    - `name` string, required: Name
  - `permission` PermissionDto[]: Article permissions
    - `permissionType` 'All' | 'Customer' | 'Employee', required: Permission type
    - `groups` PersonDto[]: Groups with permission
      - `id` string, required: ID
      - `name` string, required: Name
  - `seo` SeoDto: SEO information
    - `title` string: SEO title
    - `description` string: SEO description
    - `imageUrl` string: SEO image URL
  - `tags` TagDto[]: Article tags
    - `id` string, required: Tag ID
    - `name` string, required: Tag name
  - `relatedArticles` RelatedArticleDto[]: Related articles
    - `id` string, required: Related article ID
    - `title` string, required: Related article title
    - `url` string, required: Related article URL
  - `sections` ArticleSectionDto[], required: Article sections
    - `id` string, required: Section ID
    - `title` string, required: Section title
  - `author` AuthorDto, required: Article author
    - `id` string, required: Author ID
    - `name` string, required: Author name
    - `imageUrl` string: Author image URL
  - `lastDraftBy` AuditUserDto: Last draft by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `lastPublishedBy` AuditUserDto: Last published by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `createdBy` AuditUserDto: Created by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `updatedBy` AuditUserDto: Updated by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `id` string: Article ID (use 00000000-0000-0000-0000-000000000000 for new articles)
  - `articleId` string: Article ID (use 00000000-0000-0000-0000-000000000000 for new articles)
  - `plainText` string: Article plain text content

## Response `201`

- ArticleResponse
  - `culture` string: Culture/Language code
  - `title` string, required: Article title
  - `subtitle` string: Article subtitle
  - `url` string, required: Article URL (relative path)
  - `content` string, required: Article content in HTML format
  - `snippet` string: Article snippet/summary
  - `status` 'Unpublished' | 'PublishedWithChanges' | 'Published' | 'Draft' | 'Empty', required: Article status (will be forced to Draft)
  - `moduleId` string, required: Knowledgebase Module ID
  - `mainSection` string, required: Main section ID
  - `orderId` number: Article order ID
  - `categoryIds` string[], required: Category IDs
  - `sectionIds` string[], required: Section IDs
  - `editors` PersonDto[]: Article editors
    - `id` string, required: ID
    - `name` string, required: Name
  - `permission` PermissionDto[]: Article permissions
    - `permissionType` 'All' | 'Customer' | 'Employee', required: Permission type
    - `groups` PersonDto[]: Groups with permission
      - `id` string, required: ID
      - `name` string, required: Name
  - `seo` SeoDto: SEO information
    - `title` string: SEO title
    - `description` string: SEO description
    - `imageUrl` string: SEO image URL
  - `tags` TagDto[]: Article tags
    - `id` string, required: Tag ID
    - `name` string, required: Tag name
  - `relatedArticles` RelatedArticleDto[]: Related articles
    - `id` string, required: Related article ID
    - `title` string, required: Related article title
    - `url` string, required: Related article URL
  - `sections` ArticleSectionDto[], required: Article sections
    - `id` string, required: Section ID
    - `title` string, required: Section title
  - `author` AuthorDto, required: Article author
    - `id` string, required: Author ID
    - `name` string, required: Author name
    - `imageUrl` string: Author image URL
  - `lastDraftBy` AuditUserDto: Last draft by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `lastPublishedBy` AuditUserDto: Last published by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `createdBy` AuditUserDto: Created by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `updatedBy` AuditUserDto: Updated by user
    - `id` string, required: User ID
    - `name` string, required: User name
    - `date` string: When action occurred
  - `id` string, required: Article ID
  - `articleId` string, required: Article ID
  - `plainText` string, required: Article plain text content

## Changes

- **2026-11-03** `cf3224b37a34`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/octadesk/apis/octadesk-api/changes/knowledgebase/articles/draft/post.md)

---

[API](https://skmtc.dev/octadesk/apis/octadesk-api.md) - [All operations](https://skmtc.dev/octadesk/apis/octadesk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octadesk/apis/octadesk-api/revisions/cf3224b37a34?raw)
