🏷️ API version: 2025-10

You can now use the add_content_to_doc_from_markdown mutation to add markdown content to an existing monday doc. The content is then parsed and converted to the corresponding document block type.

mutation {
  add_content_to_doc_from_markdown(
    docId: 123456, 
    markdown: "# Markdown Example\n\n**Bold text**, *italic text*, and `inline code`.\n\n- Item one\n- Item two\n\n> A simple blockquote."
  ) {
    success
    block_ids
    error
  }
}
🏷️ API version: 2025-10

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"
  }
}
🏷️ API version: 2025-10

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.

🏷️ API version: 2025-10

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
  } 
}
🏷️ API version: 2025-10

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"]   
      }
    }
  }
}
🏷️ API version: 2025-10

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
🏷️ API version: 2025-10

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"
  }
}
🏷️ API version: 2025-10

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