API Migration Bootcamp – Follow up with resources

Hey y’all, here are answers to the most popular & relevant questions from today’s stream. Thank you everyone for joining!

How to’s

How can we specify the new version when using the monday SDK?

You can set the version to be used by the mondaySDK object:

import mondaySdk from "monday-sdk-js";

const monday = mondaySdk();
monday.setApiVersion("2023-10");

Or you can pass the version in the options of a specific API call:

import mondaySdk from "monday-sdk-js";
const monday = mondaySdk();

const data = await monday.api(query, { variables, apiVersion: "2023-10"});

Can I return specific columns with the items_page object?

Yes, you can still return specific columns using the item_page object. Here’s how:

query  {
  boards(ids: 872058179) {
    items_page (limit:1) {
      cursor
      items {
        id
        name
        column_values (ids:["status"]) {
          id
          value
        }
      }
    }
  }
}

Currently many IDs are a string of numbers – e.g. my account ID is 1825528. Are they going to become text anytime soon?

From a type-safety perspective, we want developers to think of IDs as an arbitrary alphanumeric string.

Transparently, we don’t have any plans to change the structure of these IDs. But plans change and your applications should work regardless of what the ID string looks like.

Third party integrations

Will these API updates change external integrations like Zapier or Make? Is monday working directly with these companies

Third-party integrators like Make will need to update their connectors, and depending on how you’re using those connectors, you may need to update your workflows too.

We have reached out to them and shared the deprecation plan, and will continue to work with them to ensure they’re keeping up with our timeline.

I’m also going to pass the feedback from today over to their teams so they know that our shared customers (aka you) are expecting a prompt update from them.

If I only use a few marketplace apps and no third-party integrations, will this migration really affect me?

Candidly, not really.

These migration materials are aimed at app developers or admins who run externally-integrated workflows inside their monday account.

As I mentioned on the call, the majority of apps can update to the new version with no user impact. Majority doesn’t mean all, so just keep an eye out for communications from the app developers (via email) and you’ll be fine.

Future plans and requests

Are there plans to increase complexity limits?

We are working on an infrastructure to better measure complexity so that low-volume use cases are not penalized as much.

We don’t have plans to increase the limit per se, but we want to make the calculation more fair and usage-based.

Will the new API support more columns like formula?

Good question – we’re working on it! A side benefit of mondayDB is being able to eventually support formulas in the API 🙂 If you look at our mondayDB website, you’ll see that “Formula column in automations” is on the roadmap for 2024 – API support will be released with it or soon after!

Have any further questions? Create a new topic in the community and we’ll be happy to help 🙂

Hi @dipro Thanks for that.

I am trying to find answer for this question, can you please suggest something?

Basically trying to replicate how monday.com shows number of items in each group

Hello @gary,

I replied in the other topic!

Cheers,
Matias

hi @dipro

Thank you for your writeup. I was not able to find monday.setApiVersion in other docs / posts. Is there a minimum version for this function? I get “is not a function” using 0.4.11

Also, what is the recommended way to call the API from a front-end (view). I am using monday.api but I noticed most of your examples in the migration guide are using a fetch to “https://api.monday.com/v2”

Hey @basdebruin –

Minimum version - 0.4.11 should work. I managed to get it to work here with a small demo on my local machine:

Recommended way to call API from frontend – monday.api() is best because it lets you use seamless authentication. I use fetch in the migration guide to make it slightly more understandable for people who aren’t using JS.