`2025-01`

Breaking changes

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.

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

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.

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.

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

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.

Feel free to complete our feedback form with any comments or concerns about API version 2023-10.

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.

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 a required field
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.

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