Changelog
Apps DocsCommunityNeed Help?
Start typing to search…

New ability to create mirror and connect board columns

🏷️ API version: 2025-10

Using the existing create_column mutation, you can now create connect board and mirror columns via the API. You can query the new get_column_type_schema object to retrieve the available properties for each column type.

mutation {
  create_column(
    board_id: 1234567890
    title: "Related items (Board 9876543210)"
    column_type: board_relation
    defaults: {
      boardIds: [9876543210]
      allowMultipleItems: true
      allowCreateReflectionColumn: true
    }
  ) {
    id
    title
    type
  }
}
mutation {
  create_column(
    board_id: 1234567890
    title: "Test Column"
    column_type: mirror
    defaults: {
      relation_column: {
        board_relation: true
      }
      displayed_linked_columns: [
        { 
          board_id: "9876543210"
          column_ids: ["status"]
        }
      ]
    }
  ) {
    id
    title
    type
  }
}

New `get_column_type_schema` object

🏷️ API version: 2025-10

You can now retrieve a column’s type-specific schema using the get_column_type_schema object. The response is a JSON object that defines the schema used for creating and updating columns.

query {
  get_column_type_schema (type: board_relation)
}
{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "allowCreateReflectionColumn": {
                "type": "boolean",
                "description": "Whether to allow creation of reflection columns"
              },
              "allowMultipleItems": {
                "type": "boolean",
                "description": "Whether to allow selection of multiple items"
              },
              "boardIds": {
                "type": "array",
                "description": "Array of related board IDs",
                "items": {
                  "type": "integer"
                }
              },
              "boardId": {
                "type": "integer",
                "description": "Default board ID for the relation"
              },
              "item_ids": {
                "type": "array",
                "description": "Array of related item IDs",
                "items": {
                  "type": "integer"
                }
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

New `import_doc_from_html` mutation

🏷️ API version: 2025-10

You can now use the import_doc_from_html mutation to convert HTML content to a new monday doc. The content is then parsed and converted to the corresponding document block type.

mutation {
  import_doc_from_html(
    html: """
<!DOCTYPE html>
<html>
  <head>
    <title>Test Doc</title>
  </head>
  <body>
    <h1>Hello World</h1>
    <p>This is a <strong>fake HTML</strong> doc for testing.</p>
    <ul>
      <li>One</li>
      <li>Two</li>
      <li>Three</li>
    </ul>
  </body>
</html>
    """,
    workspaceId: 1234567890,
    title: "New Doc from HTML",
    folderId: 9876543210
  ) {
    error
    success
    doc_id
  }
}

New `add_content_to_doc_from_markdown` mutation

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

Updated complexity error format

🏷️ 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"
  }
}

Improved API complexity calculation

🏷️ 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.

New `convert_board_to_project` mutation

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

New `create_widget` mutation

🏷️ 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"]   
      }
    }
  }
}

New CRUD capabilities for managing favorites

🏷️ 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