You can now use the convert_board_to_project mutation to convert an existing board to a project board via the API. This mutation is part of a monday.com portfolio solution and only available on Enterprise plans.

mutation {
  convert_board_to_project(
    input: {
      board_id: 1234567890
      column_mappings: {
        project_status: "status_column_id"
        project_owner: "person_column_id"
        project_timeline: "date_column_id"
      }
      callback_url: "https://your-callback-url.com"
    }
  )  {
    success
    message
    process_id
    projectId
  } 
}

You can now use the create_widget mutation to create a widget on a dashboard or board view via the API.

mutation CreateBatteryWidget($settings: JSON!) {
  create_widget(
    parent: { kind: DASHBOARD, id: 12654199 }
    kind: BATTERY
    name: "TASK TRACKING"
    settings: $settings
  ) {
    id
    name
    kind
  }
}

{
  "settings": {
    "battery_data": {
      "status_column_ids_per_board": {
        "12345": ["status"]   
      }
    }
  }
}

You can now manage monday.com favorites through the platform API with full CRUD support. Use the following objects to read, create, update, and delete favorites:

• favorites query
• create_favorite mutation
• update_favorite_position mutation
• delete_favorite mutation

You can now retrieve a board's muted notification settings via the API by querying the mute_board_settings object. It returns the muted notification state for one or more boards.

query {
  mute_board_settings (board_ids: 1234567890) {
    board_id
    mute_state
  }
}

{
  "data": {
    "mute_board_settings": [
      {
        "board_id": "1234567890",
        "mute_state": "CURRENT_USER_MUTE_ALL"
      }
    ]
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

The API now supports creating and updating dashboards with the following mutations:

• create_dashboard
• update_dashboard
• update_overview_hierarchy
• delete_dashboard

The API now supports creating, updating, and deleting Workforms and their components using the following new mutations:

• Create form
• Create form question
• Create form tag
• Activate form
• Update form
• Update form question
• Update form settings
• Update form tag
• Set form password
• Shorten form URL
• Deactivate form
• Delete question
• Delete form tag

You can now use the connect_project_to_portfolio mutation to connect an existing project board to a portfolio board via the API. This mutation is part of a monday.com portfolio solution and only available on Enterprise plans.

mutation {
  connect_project_to_portfolio (projectBoardId: 1234567890, portfolioBoardId: 9876543210) {
    portfolio_item_id
    request_id
    message
		success
  }
}

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
    }
  }
}

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.