New APIs to manage knowledge base articles

🏷️ API version: 2026-04

You can now create, publish, delete, and query knowledge base articles via the API.

Queries

articles — retrieve published articles by object ID, with optional workspace filtering and pagination
article_blocks — paginate through an article's content blocks

query {
  articles(object_ids: ["12345"], limit: 10, page: 1) {
    id
    name
    privacy_kind
    blocks {
      id
      type
      content
    }
  }
}

Mutations

create_article — create a new article in a workspace
publish_article — publish a draft article with privacy and subscriber controls
delete_article — delete an article

mutation {
  create_article(
    name: "Getting started guide"
    workspace_id: "123456"
  ) {
    object_id
    name
  }
}

mutation {
  publish_article(
    object_id: "789"
    privacy_kind: PUBLIC
  ) {
    object_id
    name
    state
  }
}