Changelog
Apps DocsCommunityNeed Help?
Start typing to search…

Deprecating `settings_str` field on `columns`

🏷️ API version: 2025-10

The settings_str field on columns queries is now deprecated. You can use the new settings field to return the column's settings as a JSON object.

query {
  boards (ids: 1234567890) {
    columns {
      settings
    }
  }
}
{
  "data": {
    "boards": [
      {
        "columns": [
          {
            "settings": {}
          },
          {
            "settings": {}
          },
          {
            "settings": {
              "labels": [
                {
                  "id": 0,
                  "color": 0,
                  "label": "Working on it",
                  "index": 0,
                  "is_done": false,
                  "is_deactivated": false
                },
                {
                  "id": 1,
                  "color": 1,
                  "label": "Done",
                  "index": 2,
                  "is_done": false,
                  "is_deactivated": false
                },
                {
                  "id": 2,
                  "color": 2,
                  "label": "Stuck",
                  "index": 1,
                  "is_done": false,
                  "is_deactivated": false
                }
              ]
            }
          },
          {
            "settings": {}
          },
          {
            "settings": {}
          },
          {
            "settings": {
              "hide_footer": false
            }
          },
          {
            "settings": {}
          }
        ]
      }
    ]
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

New `columns` fields

🏷️ API version: 2025-10

You can now query a column's settings, revision data, and capabilities with the following new fields:

  • settings
  • revision
  • capabilities
query {
  boards (ids: 1234567890) {
    columns {
      settings
      revision
      capabilities {
        calculated {
          function
          calculated_type
        }
      }
    }
  }
}

New ability to create, read, and delete required field columns

🏷️ API version: 2025-10

Using the new validations endpoint, you can now query a board's required field columns. This query returns a JSON object containing metadata about a collection of required field columns.

query {
  validations(
    id: 1234567890
	) {
    required_column_ids
		rules
  }
}

You can also add and remove required field columns via the API using the following mutations:

New ability to create, read, update, and delete monday.com objects

🏷️ API version: 2025-10

Using the new objects endpoint, you can now query monday.com objects. Objects are a core component of the platform API that represent a generic item within the monday.com platform.

This query returns a JSON object containing metadata about a collection of objects.

query {
  objects(
    limit: 4, 
    state: ACTIVE, 
    order_by: CREATED_AT
  ) {
    id
    name
    owners {
      id
      name
    }
  }
}

You can also create, update, and delete objects via the API using the following mutations:

New `notifications_settings` object

🏷️ API version: 2025-10

You can now read a user's notification settings across all channels with the notifications_settings object.

query {
  notifications_settings(
    channels: [Email, Slack]
    scope_type: AccountNewUserDefaults
  ) {
    kind
    description
    is_for_admins_only
    is_for_non_guests_only
    channels {
      name
      enabled
      editable_status
    }
  }
}
{
  "data": {
    "notifications_settings": [
      {
        "kind": "invitation",
        "description": "Invitations to workspace, board, doc, item, or team",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "notify_auth_domain_signup",
        "description": "Signed up with an email address from my account domain",
        "is_for_admins_only": true,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "ask_for_permissions",
        "description": "Requests access to boards & dashboards",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "invitation_requests_admins_reminder_setting",
        "description": "Pending invite requests when invite requests have been pending for over 7 days",
        "is_for_admins_only": true,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "mention",
        "description": "Mentioned me in an update or reply",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": true,
            "editable_status": "Editable"
          }
        ]
      },
      {
        "kind": "notify_invitee_join",
        "description": "Signed up after I have invited them",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "dlp_file_deleted_setting",
        "description": "File has been deleted for breaching data policies",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "new_post_on_owned_item",
        "description": "Wrote an update on an item I own",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "like_your_post",
        "description": "Reactions to my update",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "daily_digest",
        "description": "My highlights",
        "is_for_admins_only": false,
        "is_for_non_guests_only": true,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "dlp_update_deleted_setting",
        "description": "Update has been deleted or redacted for breaching data policies",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "request_to_install_and_purchase_apps",
        "description": "Requests installation to install & purchase apps",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "notify_invitee_didnt_join",
        "description": "Didn’t sign up after I have invited them",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "assign",
        "description": "Assigned me to an item",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": true,
            "editable_status": "Editable"
          }
        ]
      },
      {
        "kind": "new_post_on_subscribed_item",
        "description": "Wrote an update on an item I’m subscribed to",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "automation",
        "description": "Automations via an automation",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "api",
        "description": "Platform API custom notifications using the GraphQL API",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "automation_product",
        "description": "Automations with a \"notify\" step this does not include \"send an email\" automations",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "reply_your_reply",
        "description": "Replied to a thread I commented on or reacted to",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "automation_system",
        "description": "Automation failures when automations don’t run as expected",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "reply_your_post",
        "description": "Replied to an update I wrote",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": true,
            "editable_status": "Editable"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      },
      {
        "kind": "template_update",
        "description": "Template changes by the template owner",
        "is_for_admins_only": false,
        "is_for_non_guests_only": false,
        "channels": [
          {
            "name": "Email",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          },
          {
            "name": "Slack",
            "enabled": false,
            "editable_status": "AllRelatedNotificationsDontHaveChannel"
          }
        ]
      }
    ]
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

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