Deprecation notice: server-side usage of monday-sdk-js

Hi developers,

We’re continuing to evolve monday’s developer platform to align with modern JavaScript runtimes and frameworks. As part of this, we’re updating our guidance for how apps should make server-side API calls.

What’s changing

Modern Node versions (Node 18+) include native fetch. Because monday-sdk-js relies on node-fetch for server-side usage, this can cause errors in modern JavaScript frameworks such as Next.js.

Because of this, and based on how the platform has evolved, we are updating our recommended approach for server-side API interactions.

Server-side usage of monday-sdk-js is being deprecated

We are deprecating server-side usage of monday-sdk-js.

In an upcoming major release of monday-sdk-js (v1.0.0), all server-side support will be removed. Client-side usage is not affected at this time.

This is a deprecation notice, not a breaking change. Existing versions of monday-sdk-js will continue to work, but no new server-side features or compatibility fixes will be added. 

What to use instead

For all server-side interactions with the monday platform API, @mondaydotcomorg/api is now the recommended and officialy supported SDK.

This SDK:

• Uses native fetch
• Fully supports modern JS frameworks
• Provides full TypeScript support
• Offers improved developer experience

Migrating is straightforward

You can continue using your existing GraphQL queries. The new SDK supports passing query strings directly.

Server-side example

import { ApiClient } from "@mondaydotcomorg/api";
const client = new ApiClient({ token });
const result = await client.request<{ boards: { name: string }[] }>(
  `query { boards(ids: some_id) { name } }`
);

Client-side usage

Client-side API calls are still supported in two ways:

• Continue using monday-sdk-js for view apps
• Or use @mondaydotcomorg/api, including the SeamlessApiClient, which does not require an API token in monday view apps

What you should do now

If your app:

• Uses modern js frameworks (such as Next.js 14+)
• Makes API calls from the backen

You should plan to migrate server-side logic to @mondaydotcomorg/api

Thanks for building with monday.

The monday Apps Framework team 💙