Actively supported versions

This document highlights actively supported API versions in reverse chronological order, so you can quickly see the latest features, fixes, and changes.

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

2025-10

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

---

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

---

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

---

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.

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