We've updated the format for max complexity per request errors. If you make a request that is more then the allowed complexity, you'll now receive the following error:

{
  "errors": [
    {
      "message": "Max allowed complexity per request exceeded",
      "extensions": {
        "code": "REQUEST_MAX_COMPLEXITY_EXCEEDED",
        "cost": 5,
        "max_complexity_per_request": 5000000
      }
    }
  ],
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

We’ve improved how query complexity is calculated and charged:

• Complexity is now estimated based on the variables you provide. We charge what we think the query will cost, and once the results are returned, you are reimbursed or charged according to the actual cost. If needed, adjustments are made from the following minute’s allowance.
• Failed queries/errors now cost significantly less.
• The complexity error format has been updated (read more here).

For many queries, this means that you'll get points back rather than being charged more. These changes make complexity easier to predict and better aligned with API best practices.

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