Articles are part of monday.com's Knowledge Base feature. They let teams create and share knowledge articles inside workspaces, so documentation stays organized and easy to find.

🚧

Only available in API versions 2026-04 and later

Queries

Get articles

Returns published articles for the given object IDs. Each Article includes a metadata object and a blocks array (the first page of content blocks; use article_blocks to load more).

• Required scope: docs:read
• Returns [Article]!
• Can only be queried at the root; can't be nested inside another field

query {
  articles(
    object_ids: [1234567890]
    workspace_ids: [9876543210]
    limit: 25
    page: 1
  ) {
    metadata {
      object_id
      name
      state
    }
    blocks {
      id
    }
  }
}

Arguments

Get article blocks

Returns paginated content blocks for the published version of a single article, when the requesting user has access.

• Required scope: docs:read
• Returns [ArticleBlock]!
• Can only be queried at the root; can't be nested inside another field

query {
  article_blocks(object_id: "1234567890", limit: 25, page: 1) {
    id
  }
}

Arguments

Knowledge base search

Runs an AI-powered search across the knowledge base: it returns an LLM-generated answer plus the underlying source snippets.

• Required scope: docs:read
• Returns KnowledgeBaseAnswer
• Can only be queried at the root; can't be nested inside another field

query {
  knowledge_base_search(query: "How do I reset a password?", limit: 5) {
    answer
    raw_snippets {
      id
      title
      text
      url
    }
  }
}

Arguments

Fields (KnowledgeBaseAnswer)

Mutations

Required scope: docs:write

Create article

Creates a new knowledge base article (draft). Returns ArticleMetadata.

mutation {
  create_article(
    name: "Getting started"
    workspace_id: "1234567890"
    folder_id: "9876543210"
  ) {
    object_id
    name
    workspace_id
  }
}

Arguments

Publish article

Publishes a draft article and sets visibility and subscribers. Subscriber add/remove arguments apply when privacy_kind is PRIVATE. Returns ArticleMetadata.

mutation {
  publish_article(
    object_id: "1234567890"
    privacy_kind: PUBLIC
    folder_id: "9876543210"
    add_subscriber_ids: [111, 222]
    add_subscriber_team_ids: [333]
    remove_subscriber_ids: []
    remove_subscriber_team_ids: []
  ) {
    object_id
    privacy_kind
    state
  }
}

Arguments

Delete article

Deletes an article by object ID. Returns ArticleMetadata.

mutation {
  delete_article(object_id: "1234567890") {
    object_id
    state
  }
}

Arguments