Actively supported versions

This document lists the actively supported API versions in reverse chronological order, allowing you to quickly view the latest features, fixes, and changes.

Versions earlier than 2025-04 are deprecated and no longer supported, but we’ve kept them in a Deprecated versions section at the bottom for migration and troubleshooting reference.

2026-07

Non-breaking changes

• New create_validation_rule, update_validation_rule, and delete_validation_rule mutations for board validation rules (see Validation rules guide)
• New create_doc_blocks mutation with structured CreateBlockInput for rich document blocks (see Document blocks V2)
• New inferred_metadata and manual_metadata fields on the Board type

2026-04

Breaking changes

• The value_string, value_int, value_float, and value_boolean fields on AggregateGroupByResult have been replaced by a unified value field of type JSON

Non-breaking changes

• New create_project mutation
• New set_item_description_content mutation
• New create_marketplace_app_discount mutation
• New feature-level lifecycle event subscriptions APIs
• New APIs to manage departments
• New ability to update an item's nickname
• New search query for cross-entity search across items, boards, and documents
• New articles query and mutations for Knowledge Base article CRUD and publishing
• New article_blocks query for paginated article content blocks
• New knowledge_base_search query for AI-powered knowledge base search
• New doc_version_history query to retrieve document version snapshots
• New doc_version_diff query to compare document versions
• New notetaker query namespace for meeting recordings, transcripts, summaries, and action items
• New object_relations query and mutations for managing relations (aliases and dependencies) between objects
• New relations argument on create_object mutation
• New relations field on Object type
• New allowed_sequences_to_enroll query and enroll_items_to_sequence mutation for email sequences
• New tool_events query for MCP tool execution events in automations
• New ask_developer_docs query for AI-powered developer documentation answers
• New prompt argument on create_board mutation to generate board structure via AI
• New query_params argument on workspaces query to filter by account product kind
• New created_from_board_id and folder fields on Board type
• New department field on User type
• New attribution_entity_ref and attribution_entity_type fields on Like type for reaction attribution
• New app_feature_slug field on Folder type
• New APP_FEATURE and LISTVIEW values on ExternalWidget enum

2026-01

Non-breaking changes

• New aggregate object
• New max_units field
• New updated_at field
• New width argument on update_column mutation
• New created_at field on account
• New membership_kind argument on workspaces
• New is_trial_expired and is_during_trial fields on account
• New mutations to create status and dropdown columns attached to managed columns
• New Resource Directory APIs
• New tier field available on account products queries

2025-10

Breaking changes

• Updated complexity error format

Non-breaking changes

• New update_doc_name mutation
• New duplicate_doc mutation
• New delete_doc mutation
• New change_item_position mutation
• New ability to change a workspace's account product
• New set_board_permissions mutation
• New update_board_hierarchy mutation
• New update_folder mutation arguments
• New views fields
• New replies arguments
• New create_update arguments
• Filter for board level updates in the updates field
• New create_portfolio mutation
• New ability to read Workforms
• New connect_project_to_portfolio mutation
• New ability to create, update, and delete Workforms
• New mutations to create, update, and delete dashboards
• New mute_board_settings object
• New CRUD capabilities for managing favorites
• New create_widget mutation
• New convert_board_to_project mutation
• Improved API complexity calculation
• New mutations to create, update, and delete board views
• New add_content_to_doc_from_markdown mutation
• New import_doc_from_html mutation
• New get_column_type_schema object
• New ability to create mirror and connect board columns
• New update_mute_board_settings mutation
• New notifications_settings object
• New ability to create, read, update, and delete monday.com objects
• New mutations to create and update app features
• New ability to create, read, and delete required field columns
• New columns fields
• New API support for multi-level boards
• New update_column mutation
• New delete_widget mutation
• New app fields
• New mutations to create and update apps
• New mutations to create status and dropdown columns
• New item_nickname argument on create_board mutation
• New mutations to update dropdown and status columns
• New export_markdown_from_doc object
• Deprecating settings_str field on columns

---

2025-07

Hotfixes

• April 28th, 2025: For column value exception errors, the column_type property no longer returns "Column" appended to the column type. Read more here.
• May 19th, 2025: All API responses now contain a unique request ID. Read more here.

Breaking changes

• Updated complexity budget exhausted error
• Updated unauthorized user error code

Non-breaking changes

• New argument to create empty boards
• New argument to specify product for workspace creation
• New field to retrieve assets on Reply object
• New item description field
• New CRUD capabilities for managed columns
• New mentions_list argument in create_update mutations
• New arguments to filter updates by date
• New fields for boards queries
• New access_level field for board view queries
• New ability to read audit logs via the API
• New audit_event_catalogue object to retrieve a list of supported audit log events

---

2025-04

Hotfixes

• February 18th, 2025: The complexity budget exhausted error format has changed. Read more here.
• February 24th, 2025: The create_webhook mutation now returns descriptive errors. Read more here.
• February 24th, 2025: The renewal_date field is no longer required when querying app subscription details. Read more here.
• February 27th, 2025: We've introduced changes to the subitems query to help increase performance and return consistent results. Read more here.
• April 28th, 2025: For column value exception errors, the column_type property no longer returns "Column" appended to the column type. Read more here.
• May 19th, 2025: All API responses now contain a unique request ID. Read more here.

Breaking changes

• Deprecated: Sending variables as a JSON string
• Value field now returns null on connect boards, dependency, and subtasks columns

Non-breaking changes

• New page_break type on create_doc_block mutation
• New invite_users mutation
• New end_date field on app subscription details object
• New update user attributes mutation
• New max_units field on app subscription queries
• New max_units argument on set mock app subscription mutations
• New ability to query user profile custom fields
• New account_roles object
• New ability to update a user's custom role
• New platform_api object to query daily API usage
• New object to query app data

---

Deprecated versions

This section covers API versions that are deprecated and no longer supported. They are documented here for historical and migration reference only. Review our API versioning policy for upcoming deprecation timelines.

2025-01

Hotfixes

• February 18th, 2025: The complexity budget exhausted error format has changed. Read more here.
• February 24th, 2025: The create_webhook mutation now returns descriptive errors. Read more here.
• February 24th, 2025: The renewal_date field is no longer required when querying app subscription details. Read more here.
• February 27th, 2025: We've introduced changes to the subitems query to help increase performance and return consistent results. Read more here.
• April 28th, 2025: For column value exception errors, the column_type property no longer returns "Column" appended to the column type. Read more here.
• May 19th, 2025: All API responses now contain a unique request ID. Read more here.

Breaking changes

• New unified error responses that comply with the GraphQL standard
• More spec-compliant GraphQL query validation
• Column validation for apps
• Account ID no longer returned by default
• New pagination limit for updates queries
• GraphQL queries now required in request body

Non-breaking changes

• New create and delete team mutations
• New app_subscriptions object
• New updates fields
• New ability to read the formula column
• New deactivate_users mutation
• New update_users_role mutation
• New assign_team_owners mutation
• New remove_team_owners mutation
• New update_email_domain mutation
• New timeline object
• New activate_users mutation
• New timeline_item fields

---

2024-10

Hotfixes

• October 22nd, 2024: The item_id argument on the pin_to_top and unpin_from_top mutations has changed from type Int to ID and is no longer required. Read more here.
• November 6th, 2024: We made version 2024-10backward compatible to resolve parsing errors. Read more here.
• November 19th, 2024: Updates should be returned in reverse chronological order instead of chronological order. Read more here.
• February 24th, 2025: The create_webhook mutation now returns descriptive errors. Read more here.
• February 27th, 2025: We've introduced changes to the subitems query to help increase performance and return consistent results. Read more here.
• April 28th, 2025: For column value exception errors, the column_type property no longer returns "Column" appended to the column type. Read more here.
• May 19th, 2025: All API responses now contain a unique request ID. Read more here.

Non-breaking changes

• New marketplace_app_discounts object
• New grant_marketplace_app_discounts and delete_marketplace_app_discounts mutations
• New errors object in API errors
• New descriptive field limit exceeded error
• New descriptive JSON parse error
• New Emails & Activities timeline_items object
• New Emails & Activities custom_activity object
• New updates object queries and mutations
• New team_owners and team_subscribers fields on boards queries

---

2024-07

Hotfixes

• April 1st, 2024: You can now filter the date column with multiple exact dates. Check out the full announcement here.
• May 1st, 2024: Changes to the ComplexityException error structure and error code were reverted. Read more here.
• May 9th, 2024: The addition of the data object to error codes has been rolled back until version 2025-01. Read more here.
• May 14th, 2024: Changes to the ComplexityException error message were reverted. Read more here.
• June 19th, 2024: New descriptive JSON parse error added to all API versions. Read more here.
• June 20th, 2024: You can now use the add_teams_to_board mutation to subscribe everyone in an account to a board. Check out the full announcement here.

Non-breaking changes

• New active_members_count field on account queries
• New apps_monetization_info object

2024-04

Hotfixes

• March 26th, 2024: Mutations with the column_values argument now accept both string and integer IDs. Check out the full announcement here.
• April 1st, 2024: You can now filter the date column with multiple exact dates. Check out the full announcement here.
• May 1st, 2024: Changes to the ComplexityException error structure, error code, and error message were reverted. Read more here.
• May 14th, 2024: Changes to the ComplexityException error message were reverted. Read more here.
• June 19th, 2024: New descriptive JSON parse error added to all API versions. Read more here.
• June 20th, 2024: You can now use the add_teams_to_board mutation to subscribe everyone in an account to a board. Check out the full announcement here.

Breaking changes

• New kind field accepted enum values on version and versions queries
• Updated field types on app_installs queries

Non-breaking changes

• New voters field on VoteValue
• New url field on boards and items queries
• New group_color argument for create_group mutation
• New display_value field on version and versions queries
• New account_id argument and permissions field on app_installs queries
• New position_relative_method and relative_to arguments on create_item mutation
• New is_default_workspace field on workspaces queries
• New date column filtering with multiple exact dates
• Create a doc column using the create_column mutation
• New app_subscription_operations queries and mutations

2024-01

Hotfixes

• March 26th, 2024: Mutations with the column_values argument now accept both string and integer IDs. Check out the full announcement here.
• May 1st, 2024: Changes to the ComplexityException error structure, error code, and error message were reverted. Read more here.
• May 14th, 2024: Changes to the ComplexityException error message were reverted. Read more here.
• June 19th, 2024: New descriptive JSON parse error added to all API versions. Read more here.
• June 20th, 2024: You can now use the add_teams_to_board mutation to subscribe everyone in an account to a board. Check out the full announcement here.

Breaking changes

• Typo fix in the UserUnauthorizedException error code
• New DeleteLastGroupException error

Non-breaking changes

• New app_installs object to retrieve app installation data
• New pricing_version field on app subscription queries
• New team_owners_subscribers field on workspaces queries
• New delete_teams_from_board mutation
• New kind argument on add_teams_to_board
• New add_users_to_team and remove_users_from_team mutations
• New update_workspace mutation

2023-10

Hotfixes

• December 3rd, 2023: We aligned the empty value results for the text field when querying through column_values V2 to the behavior seen in version 2023-07. Check out the full announcement here.
• March 26th, 2024: Mutations with the column_values argument now accept both string and integer IDs. Check out the full announcement here.
• June 19th, 2024: New descriptive JSON parse error added to all API versions. Read more here.
• June 20th, 2024: You can now use the add_teams_to_board mutation to subscribe everyone in an account to a board. Check out the full announcement here.

Breaking changes

• Removed the deprecated items field on boards queries, replaced it with items_page

• Removed the deprecated items field on groups queries, replaced it with items_page

• New column values fields and typed column values

• Removed the deprecated items_by_column_values and items_by_multiple_column_values objects, replaced them with items_page_by_column_values

• The column_type field on the create_column mutation is now required

• Empty parentheses are no longer supported

• Quotation marks for strings are now required

• Removed the deprecated pos fields on boards and columns queries

• Column type strings have changed. The type field on columns queries has changed from String! to ColumnType!

• Deprecated the newest_first argument on boards queries

• Many of the ID arguments and fields have changed from Int to ID type

• Text field returns empty results for mirror, dependency, and connect boards columns when querying through column_values or the specific MirrorValue, DependencyValue and BoardRelationValue types. Use the display_value field instead.

Non-breaking changes

• New next_items_page object for cursor-based pagination

• New move_item_to_board mutation

• New linked_items field on items queries

• New edit_update and delete_update webhooks

• The value argument in the change_simple_column_value mutation is now nullable

• The complexity of the text field for mirror, link, and dependency columns increased

• New ids argument on updates queries