The newest_first argument for boards queries will be deprecated in API version 2023-10. You can instead use the order_by argument and sort by the creation date, so the most recently created boards will be listed first.

Sample query

query {
  boards (ids: 1234567890, order_by: created_at) {
    id
  }
}

We will remove the deprecated pos field on boards and columns queries in API version 2023-10.

You can use the new linked_items field to return an item's linked items. The response is an array that contains the unique identifiers of the linked items.

This field is only available in API versions 2023-10 and later!

Sample query

query {
  items (ids: 9876543210) {
    linked_items (linked_board_id:1234567890, link_to_item_column_id:"connect_boards") {
      id
    }
  }
}

Sample response

{
  "data": {
    "items": [
      {
        "linked_items": [
          {
            "id": "1122334455"
          },
          {
            "id": "5544332211"
          }
        ]
      }
    ]
  },
  "account_id": 12345678
}

The new edit_update and delete_update webhooks allow you to listen to boards to notify you when an update is edited or deleted. These events are only available in API versions 2023-10 and later.

The new move_item_to_board mutation allows you to easily move an item between boards via the API. If an item has subitems, they will also move with the item. Please note that if you do not provide column mapping, the system will try to map the item according to the column name and type.

The mutation is only available in API versions 2023-10 and later!

Sample mutation

mutation {
  move_item_to_board (board_id:1234567890, group_id: "new_group", item_id:9876543210) {
    id
  }
}

Breaking changes

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

• New column values fields and typed column values

• Deprecated the items_by_column_values and items_by_multiple_column_values objects, replacing 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

• 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

Non-breaking changes

• 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

We just added the create_doc mutation that allows you to create a new doc in a document column!

mutation {
  create_doc (location: { board: {item_id: 1234567890, column_id: "monday_doc"}}) {
    id
  }
}

We now will use versioning to provide a stable API to our third-party developers while simultaneously allowing the API to evolve and improve!

We support three different versions of the API: stable, deprecated, and preview. Each quarter, we will release updated versions that contain new features, updates, bug fixes, or deprecations. To access a specific version, you can send the API-Version header in your request (check out an example here!)

• Stable: 2023-04
• Deprecated: 2023-01
• Preview: 2023-07

Further, we’ve also added the version and versions APIs that you can query to retrieve information about the version you used in your request or all of the currently supported versions.

Check out our guide for more information about API versioning!

Did you know that you can also use the create_column mutation to add a status or dropdown column with custom labels to a board?

This method requires you to send the label values as JSON strings using the defaults argument, so ensure that your JSON is formatted properly to avoid errors. Check out our documentation to see a few examples!

You can now query and mutate the brand-new folders object via the API! Querying the new object will return metadata about one or a collection of folders and their contents. You can also use one of the new mutations to create, update, or delete folders. Check out our folders API reference for all of the details!