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

Argument	Type	Description
`object_ids`	`[ID!]!`	Required. Article object IDs (for example, from the article URL).
`workspace_ids`	`[ID!]`	Optional. Limit results to these workspaces.
`limit`	`Int`	Max articles per page. Default: `25`.
`page`	`Int`	Page number (1-based). Default: `1`.

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

Argument	Type	Description
`object_id`	`ID!`	The article's object ID.
`limit`	`Int`	Max blocks per page. Default: `25`.
`page`	`Int`	Page number (1-based). Default: `1`.

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

Argument	Type	Description
`query`	`String!`	Natural-language search text.
`limit`	`Int`	Max snippets to consider. Default: `5`.

Fields (`KnowledgeBaseAnswer`)

Field	Type	Description
`answer`	`String`	Generated answer text from the model.
`raw_snippets`	`[SnippetSearchResult]`	Matching source snippets used for grounding.

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

Argument	Type	Description
`name`	`String`	Optional display name for the article.
`workspace_id`	`ID!`	Workspace where the article is created.
`folder_id`	`ID`	Optional folder to place the article under.

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

Argument	Type	Description	Enum values
`object_id`	`ID!`	The article's object ID.
`privacy_kind`	`PrivacyKind!`	Whether the article is visible only to subscribers or workspace-wide.	`PRIVATE`, `PUBLIC`
`folder_id`	`ID`	Optional folder for the published article.
`add_subscriber_ids`	`[ID!]`	User IDs to add as subscribers (private articles).
`add_subscriber_team_ids`	`[ID!]`	Team IDs to add as subscriber groups (private articles).
`remove_subscriber_ids`	`[ID!]`	User IDs to remove from subscribers.
`remove_subscriber_team_ids`	`[ID!]`	Team IDs to remove from subscribers.

Delete article

Deletes an article by object ID. Returns ArticleMetadata.

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

Arguments

Argument	Type	Description
`object_id`	`ID!`	The article to delete.