Product updates

We released API version 2023-10 on July 1! It features many new and exciting updates, as well as a handful of breaking changes (read more about API versioning here). We put together this guide (complete with a detailed explanation for each change) to help make the transition to the new version easier! Check out all of the changes below, and make sure to click on each item’s respective link to see the full details about each update 😃 After checking out the updates, we would love to hear from you! Your opinions and feedback are vital to building, maintaining, and improving our API. Feel free to submit our feedback form or post any questions in the comments below! Here’s what’s new 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 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

Yesterday we implemented the new sandboxing restrictions, but we have decided to revert the update to give app developers more time to test their apps against the new restrictions. As of now, the five original directives will remain the same. If your app requires a popup, please check out the new SDK method that allows you to open links in a new tab. Please test your app in the sandboxed environment to ensure that you don’t have any issues when the new restrictions are implemented. If you do, please reach out to us as soon as possible to identify a possible workaround. We will update you shortly on any changes to the restrictions, including the new release date, in the changelog, here in the community, and via email. Please comment below or message me your email address if you’re interested in receiving updates there 😃

Part 2 of sandboxing for all iframes will now be implemented on July 5th, 2023 to give developers more time to test their apps against the new restrictions. Please note that the original directives will remain the same: allow-forms: Allows the page to submit forms. The form will be displayed as normal, but submitting it will not trigger input validation, sending data to a web server, or closing a dialog if this keyword is not used. allow-downloads: Allows downloading files through an <a> or <area> element with the download attribute and through the navigation that leads to a file download. This works regardless of whether the user clicked on the link or JS code initiated it without user interaction. allow-presentation: Allows embedders to have control over whether an iframe can start a presentation session . allow-same-origin: The resource is treated as being from a special origin that always fails the same-origin policy (potentially preventing access to data storage/cookies and some JavaScript APIs) if this token is not used. allow-scripts: Allows the page to run scripts (but not create pop-up windows). This operation is not allowed if this keyword is not used. If you need to open a link in a new tab, you can use the new monday.execute("openLinkInTab") method. We recommend testing your app in the sandboxed environment with the new restrictions to ensure nothing breaks. You can do so by adding the _apps_sandbox=v2 query param to a monday URL. If something breaks and there’s no workaround, please complete a support request so we can find a resolution.

Due to popular demand, we’re excited to present the brand new create_doc mutation that allows you to create a new doc in a document column! Check out the documentation and give it a try 📃 mutation { create_doc (location: { board: {item_id: 1234567890, column_id: "monday_doc"}}) { id } }

We recently added an SDK method that allows view apps to open links in a new tab! 🤠 This method is particularly useful for apps impacted by the upcoming sandboxing changes. Check out our SDK documentation for more information about the method, its parameters, and a code sample 📄

We recently deployed a bug fix so the change_column_value webhook fires whenever column values in new columns on the relevant board change. Before, the webhook would only fire after registering a second change_column_value webhook on the same board. You can find more information about webhooks in our documentation!

NB: This change has been postponed. Learn more here. We previously announced part 1 of sandboxing for all iframes and are getting closer to implementing part 2 on June 28th, 2023! This involves limiting relevant apps’ actions and only allowing the following directives in our iframes: allow-forms: Allows the page to submit forms. The form will be displayed as normal, but submitting it will not trigger input validation, sending data to a web server, or closing a dialog if this keyword is not used. allow-downloads: Allows downloading files through an <a> or <area> element with the download attribute and through the navigation that leads to a file download. This works regardless of whether the user clicked on the link or JS code initiated it without user interaction. allow-presentation: Allows embedders to have control over whether an iframe can start a presentation session. allow-same-origin: The resource is treated as being from a special origin that always fails the same-origin policy (potentially preventing access to data storage/cookies and some JavaScript APIs) if this token is not used. allow-scripts: Allows the page to run scripts (but not create pop-up windows). This operation is not allowed if this keyword is not used. We recommend testing your app in the sandboxed environment with the new restrictions to ensure nothing breaks. You can do so by adding the _apps_sandbox=v2 query param to a monday URL. If something breaks and there’s no workaround, please complete a support request so we can find a resolution.

Hey y’all, we released a new version of monday vibe (our react components library). It has some breaking changes for some of you. Check out v2.0.0 on npm here. The breaking change is that this new version uses CSS modules, so any code that tries to override the styles from the library will not work correctly. If you’re not overriding the CSS, it should be a seamless upgrade. I recommend upgrading as soon as yopu can so that new components we release will work as expected. And if you’re not using Vibe yet, I suggest you do 🙂 Check out the docs here: monday vibe Drop a message here if you’re having any trouble with the upgrade!

The moment we’ve all been waiting for is finally here 🥁 We just implemented API versioning as a powerful way to continuously improve our API while providing a stable API for our third-party developers! Check out our API versioning guide for more info and examples, but in the meantime, here are a few answers to the most frequently asked questions! What versions do you support? We support three different API versions: stable , deprecated , and preview. Each quarter, we will release updated versions that contain new features, updates, bug fixes, or deprecations. What are the current versions? Stable: 2023-04 Deprecated: 2023-01 Preview: 2023-07 How do I access a specific version? All you need to do is send the API-Version header in your request (here’s an example!) How do I know what is different in each version? As always, you can see any changes or updates to the API here in the community or in our changelog. We will also share release notes about each version when they are released. Anything else? 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. If you have any questions, feel free to post them in the community! Happy 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!

We’re back with some exciting news about folders… 📁 Using the brand-new folders object, you can now query, create, update, and delete folders via the API! Check out our API reference docs for all of the details 🤩

We just added the move_subitem webhook that allows you to listen for when a subitem moves from one parent item to another. Check out our documentation to see the complete list of available event types!

We recently added the out_of_office field to the users object so you can easily check someone’s out-of-office status. The out_of_office field also supports the following fields to give you additional information about the user’s status: active disable_notifications end_date start_date type Take a look at our documentation for more info! 👀

We heard you loud and clear… 🔊 We just added 3 new query params for custom URLs that allow you to direct users to your app’s plans and pricing, how to use, and billing screens! Check out our docs to learn more about each one and find out how to build custom URLs 📄

App builders - this one is for you! We just added a new tab to the developer section that allows you to directly submit your app to the marketplace. It really is as simple as 1, 2, 3! Open your app’s management page. Click Publish to generate a shareable link. Complete the app submission form.

The position argument has also been deprecated for the update_group mutation. You can now use the group_attribute and new_value arguments to move the updated group before or after a specific group on the board. Check out our documentation to find all the details!

We’ve recently made changes to the create_group mutation and deprecated the position argument 💣 If you still want to specify the location of the new group on the board, you can use the recently released relative_to and position_relative_method arguments. Check out our documentation to read more about each of these new arguments and see them in action! mutation { create_group (board_id: 1234567890, group_name: "new group", relative_to: "test group", position_relative_method: before_at) { id } }

Due to popular demand, we recently added the ability to create columns with custom IDs! 🥳 To create a custom ID, you can now send the id argument in the create_column mutation. This is an optional argument, so you will still receive an auto-generated column ID if you don’t send it. When using the id argument, make sure the value you send meets the following requirements: [1-20] characters in length (inclusive) Only lowercase letters (a-z) and underscores (_) Must be unique - no other column on the board can have the same ID Can’t be null, blank, or an empty string If not, the mutation will fail, and the column will not be created. Check out all the details in our documentation! Happy creating 😎

I just released two new videos about workdoc apps. This one explains what workdoc apps are and the most common ways our customers use them: Intro to workdoc apps And this is a tutorial on how to build your first doc action: Build your first workdoc app We also have a new “monday app developer” Youtube channel! Check it out here: monday app developer - YouTube

Hey builders - check out this exciting opportunity 🛠️ We recently released the Doc Actions feature that enables developers to build apps for the workdocs product - monday.com’s powerful solution for creating, brainstorming, and collaborating on documents (read more about Doc Actions and its capabilities here!) As developers who are already building with monday, you have a unique opportunity to create an app that utilizes Doc Actions and enhances the experience of the workdocs product. Compatible apps submitted for review by May 31st, 2023, will be promoted under our marketplace’s Featured section. They will also be considered for publication on our social media channels and newsletters sent to monday customers. Take advantage of this opportunity to help expand monday.com’s workdocs and increase your app’s reach. We can’t wait to see the creative solutions you develop!

Hey y’all, my name is Dipro and I’m a Developer Advocate here at monday. I think I’ve spoken to many of you already – either over support tickets, through my webinars, or right here in the community 🙂 This month I’m surveying our developer community to understand what y’all think of the monday apps framework and development platform. The survey is here – the required questions will only take about 5 minutes or so. I’d love it if you could fill it out!  We’ll be using this feedback to inform our product roadmap and prioritize areas of improvement. Thank you! 🔮

Starting April 15th, 2023, we will deprecate connections from Windows Server 2012 R2, Windows 8.1, or earlier because they use weak ciphers. This update will not impact support for TLS 1.3. Check out this document to find out which systems this update impacts, how to know if you are affected, and which ciphers you can use!

We recently fixed a bug that prevented users from creating a subitem via the API if no subitems were ever made via the web. The bug fix first verifies that the board doesn’t already have a subitem column and that the user has the required permissions to edit the board structure. If so, the user can then create a board’s first subitem via the API!

We recently added two new webhook events: create_column and item_restored. You can now subscribe to these two events and listen for when a column is created or when an item is restored from the trash/archives 😃

We have some exciting news to share… If your app has a workspace template feature, users from all regions can now access it! 😎 Before, EU accounts could not access the workspace template feature of an app if it was in an account on a US server. With this update, EU accounts can now access all workspace template app features! This change is effective immediately, but please note that you must release a new minor version of your app and promote it to live before users see the impact!