Product updates

Following up from the previous board menu app features announcement… The board item menu is now available, so you can start creating all three new app features 🤠

We previously announced our AI assistant, but the moment you’ve all been waiting for is finally here… Developers can now build AI apps using our AI assistant app features 🙌 We’ve developed six app features that live in various locations in the platform, use different SDK methods, and work best with certain types of apps. You should decide which feature you’d like to build based on your app’s logic: Board header AI assistant Update AI assistant Doc header AI assistant Doc command AI assistant Doc toolbar AI assistant Doc quickstart AI assistant We’ve also compiled a quickstart guide that walks you through each step of creating an AI assistant app feature, but as always, feel free to drop your questions below ⬇️

Hi Community We have an issue with the short lived session token that is not passing properly to the iframe of the app. A fix is on its way to production. We apologize for the situation and are working on fixing the problem as soon as possible. 🙏🏼 I will update here as soon as I have more information regarding the status. 👩🏼‍💻

Drum roll please 🥁 We’re excited to present three brand new board menu app features: Board group menu Board item menu (coming soon) Board multi-item menu These new features enable to you create apps that work on a single group, a single item, or on multiple items. You can create these just like any other feature, but make sure you have developer mode turned on! You’re able to start building with the board group menu and board multi-item menu features TODAY, but the board item menu feature will be available soon. As always, we will announce the release both here in the community and the changelog 😃 Happy building 🛠️

Many exciting and significant things have been going on in the marketplace lately. 😲 In order to keep you up to date we will host an online webinar for the community as our first “MettApp” event. 🥇 What’s on the agenda? We will show you our updated and super cool Dev Center capabilities. We have opened new areas for application development in the Monday product, which are super strategic and touch the very heart of the product. This presents an incredible opportunity to develop new applications that address our users’ needs within their daily work routine on monday.com. We will introduce the updated APIs coming up in the next version and all that you need to know to get ready for the changes coming with them. We will reveal the new analytics for developers, the ability to have more visibility about your app marketing performance. It’s still working in progress and not released yet, but we are looking forward to sharing it with you as we go. We look forward to a productive and insightful event. When? Aug 16th 10 am EDT 4 pm CET Here is where you register for that one-of-a-kind-must-be-there event! 😎 👏🏼 Wednesday, August 16, 2023 2:00 PM→Wednesday, August 16, 2023 3:00 PM

We will be reindexing our API documentation search feature tonight at 11:00 PM CDT (4:00 AM UTC, 7:00 AM IDT on July 13th, 2023). During this period, the documentation and changelog search will not work. This update will not impact the API documentation itself. We expect full functionality to be restored within 2 hours but will provide additional updates if the outage will last longer than expected.

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