Product updates

I know there are a lot of updates about the new version of the API; I thought I’d compile a list of migration resources here and add to them as I go along. Want email updates for this topic? Click the bell icon at the bottom of this thread and select “Watching” to get an email for every new update! General resources API release notes – list of all the changes with a link to a detailed changelog about each one 2023-10 migration guide – covers the main changes in this version and how to adapt to them. NB: This is not an exhaustive list of changes; I’m adding to it each week! API Versioning Principles – explains our approach to API versioning and when each change will take place Tips about specific topics How to filter items using items_page with examples (from migration guide) Which IDs will stop being integers? How to return mirrored and linked data - using the linked_items field Use API warnings to know when you’re using an outdated API call Livestreams Migration Bootcamp Training Recording Interesting threads & common questions How to switch the API version you are using - in playground and HTTP requests How to handle the alphanumeric ID field I know there’s a lot of different topics to think about when migrating, hope this list is helpful for you! Shoot me a message in the comments if there are specific things you’d like to see resources for.

When a user churns from monday.com, their app subscriptions are also canceled. Therefore, the app_subscription_cancelled webhook will now contain a reason field indicating their subscription was canceled upon renewal. Currently, this is the only instance when the reason field appears, though we plan on adding support for additional reasons in the future. { "type":"app_subscription_cancelled", "data":{ "app_id":1000000000, "user_id":1, "user_email":"user1@users.com", "user_name": "User 1", "user_cluster": 'other', "account_tier": 'free', "account_name": "Demo Account", "account_slug": "test", "account_max_users": 10000, "account_id":777777, "version_data":{ "major":1, "minor":2, "patch":0, "type":"minor" }, "timestamp":"2022-06-23T00:00:00.000+00:00", "subscription":{ "plan_id":"plan1", "renewal_date":"2022-07-19T00:00:00+00:00", "is_trial":false, "billing_period":"monthly", "days_left":26, "pricing_version":5 }, "reason":"monday_subscription_cancel_on_renewal" } }

Using the create_doc mutation, you can now create a new document in a workspace (not just a monday doc column!) This mutation is available in API versions 2023-07 and later. Check it out 🤠 mutation { create_doc (location: {workspace: { workspace_id: 1234567, name:"New doc", kind: private}}) { id } }

An improved app listing page will be soon gradually released and will highlight apps values and content! We’ve been conducting interviews with costumers, testing, designing, and consulting to create a new user experience for users in the marketplace. In that spirit we designed a new listing page for apps. We wanted to make sure the page answered users’ most pertinent questions while considering installing an app What is the app value? What does the app do? Can I trust it? We designed the page to address all these questions, without compromising a top-notch user experience! Therefore, we organized all the information into three sections: Marketing - a top banner that provides a GIST of the app’s value and the most important information to users, to encourage them to keep on reading - with a bigger gallery since it’s the first thing users go to - want to see what it looks like? Check out this loom. Functionality - we gather all the information that will help users understand what the app actually do - capabilities, monday product areas they can find the app in, permissions, pricing, etc Informative - all the ‘dry info’ users might need in order to install and use the app - guides, demos, support, developer website, etcAcross all of it, we added scrolling down behavior (like on landing pages) to create a rich user experience .We tried to design an organized experience that answers all questions while being enjoyable and aesthetic. … #This is just the first phase, there will be more to come and we will keep you posted, so stay tuned. So when? It will be released gradually so we can test users’ reactions to the changes. Having personally witnessed those changes, I believe we are aiming for new wins, and that makes me excited!

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.