🏷️ API version: 2025-10

The new form query lets you read monday.com Workforms via the API. You can retrieve detailed metadata about a form, including its accessibility, appearance, features, questions, and tags.

👉 Learn more in the form reference and other types docs

query {
  form(formToken: "b7f92c1a8d4e43c6a91e5f0dbb27f94e") {
    id
    title
    active
    appearance {
      primaryColor
      showProgressBar
    }
    features {
      responseLimit {
        enabled
        limit
      }
    }
    questions {
      id
      title
      type
    }
  }
}
🏷️ API version: 2025-10

You can now use the create_portfolio mutation to create a portfolio board as part of a monday.com portfolio solution via the API.

This mutation is available on Enterprise plans only.

mutation {
  create_portfolio (
    boardName: "New Portfolio Board"
    boardPrivacy: "private"
    destinationWorkspaceId: 12345,
  ) {
    success
    message
    solution_live_version_id
  }
}

On February 15th, 2026, we will start deprecating API versions 2025-01 and 2024-10.

After this date, any calls to these versions will automatically be routed to version 2025-04. This change may cause unexpected behavior or break existing functionality.

To avoid disruptions, update your API calls to version 2025-04 (or later) before this date.

We've prepared a migration guide to help you upgrade to version 2025-04 smoothly.

Have questions? Post them in our developer community.

🏷️ API version: 2025-10

You can now use the board_updates_only argument when querying the updates field inside a boards query. This argument filters the results to return only updates posted directly on the board, excluding item-level updates.

query {
  board (ids: 1234567890) {
    updates (limit: 50, board_updates_only: true) {
      body
      id
      created_at
      creator {
        name
        id
      }
    }
  }
}
🏷️ API version: 2025-10

We added two new arguments to the create_update mutation:

  • original_creation_date: The update's original creation date. Useful in scenarios like account recovery where preserving the original creation date is necessary.
  • use_app_info: Whether to use the app's details as the creator of the update.
mutation {
  create_update (item_id: 9876543210, body: "This update will mention user 1234567890 on an item", mentions_list: [{id: 1234567890, type: User}], use_app_info: true, original_creation_date: "01-03-2025") {
    id
  }
}
🏷️ API version: 2025-10

You can now filter replies queries by board IDs, pages, and creation time ranges using the following arguments:

  • board_ids
  • created_at_from
  • created_at_to
  • limit
  • page
query {
  replies(board_ids: [1234567890], created_at_to: "2025-08-02", created_at_from: "2025-01-01") {
    body
    created_at
    edited_at
    creator {
      id
      name
    }
  }
}
🏷️ API version: 2025-10

We added new fields to the views query to return data about the view's filters, sort, settings, and tags:

  • filter
  • filter_team_id
  • filter_user_id
  • settings
  • sort
  • tags
query {
  boards (ids: 1234567890) {
    views {
      filter
      tags
      settings
      name
      id
    }
  }
}
🏷️ API version: 2025-10

You can now update a folder's position, workspace, or product using the following new arguments on the update_folder mutation:

  • account_product_id
  • position
  • workspace_id
mutation {
  update_folder (
    folder_id: 1234567890,
    name: "Updated folder name",
    account_product_id: 54321,
    position: {
      object_id: "15",
      object_type: Board,
      is_after: false
    }
  ) {
    id
    name
  }
}
🏷️ API version: 2025-10

You can now update a board's position, workspace, or product using the new update_board_hierarchy mutation.

mutation {
  update_board_hierarchy(
    board_id: 1234567890,
    attributes: {
      account_product_id: 54321
      workspace_id: 12345
      folder_id: 9876543210
      position: {
        object_id: "15",
        object_type: Overview,
        is_after: true
      }
    }
  ) {
    success
  }
}