No more extensions
As of March 5th, customers can no longer request an extension. All customers must migrate to a new API version as we near the March 18th deadline.
Any customers who requested an extension to use API version 2023-07 can keep using it until March 18th 2024.
This only applies to folks who requested an extension. If you didn't request one, your account may switch over to 2024-01 at any point.
Why are we doing this?
As you know, we are gradually making version 2024-01 the default version when using the API.
As of today (Feb 19th), some apps and accounts are using version 2023-07 as the default API version and others are using 2024-01.
The original extension date was Feb 15th, but we are giving folks more time – to March 18th. Since the change has been very gradual, we believe that postponing the deadline is the most fair option.
Can I still get an extension?
Yes, if you have not prepared your app for the breaking changes, you may request an extension using these instructions.
We recently released two new query parameters that allow you to retrieve the schema for a specific API version or the SDL version of the schema.
API version
By default, the schema is in introspection JSON format for the Current API version. You can request the schema for a different version using the optional version=<API-Version>
parameter with the version name.
For example https://api.monday.com/v2/get_schema?version=2024-04
SDL version
You can also retrieve the schema definition language (SDL) version using the optional format=sdl
parameter.
For example https://api.monday.com/v2/get_schema?format=sdl
The new group_color
argument allows you to specify a group's color when using the create_group
mutation. You can find a list of the accepted values here.
This argument is available in API versions 2024-04
and later.
mutation {
create_group (board_id: 1234567890, group_name: "new group", group_color: "#ff642e", relative_to: "test_group", position_relative_method: before_at) {
id
}
}
let query = "mutation { create_group (board_id: 1234567890, group_name: \"new group\", group_color: \"ff642e\", relative_to: \"test group\", position_relative_method: before_at) { id } }";
fetch ("https://api.monday.com/v2", {
method: 'post',
headers: {
'Content-Type' : 'application/json',
'Authorization' : 'YOUR_API_KEY_HERE',
'API-Version' : '2024-04'
},
body: JSON.stringify({
query : query
})
})
.then(res => res.json())
.then(res => console.log(JSON.stringify(res, null, 2)));
On Saturday, February 3rd, at 1:00 AM EST (US server), we will conduct planned maintenance, and the monday.com platform will be in Read Only mode.
All mutations will be blocked during this period. Any API call containing a mutation will result in the following error: "GraphQL Action Mutations::ArchivePulse has been blocked".
The total maintenance window is estimated to last for 30 minutes. Please plan accordingly!
The new DeleteLastGroupException
error occurs when you attempt to delete or archive the only group on a board. To resolve the error, ensure that the board has more than one group.
This error will appear in API versions 2024-01
and later.

We've been updating the docs to create a more straightforward and user-friendly experience - starting with the site navigation.
The API documentation has been split into two sections as part of these updates: API reference and guides.
-
The API reference section houses docs about every object, argument, and field you can query or mutate using the API. You can now search inside the API reference docs themselves to return smaller batches of more relevant results.
-
The Guides section contains all the other important information to know when using the API like versioning, introduction to GraphQL, and error codes.
You can easily flip between the two sections (+ the changelog) using the dropdown pictured below!

We recently added two new mutations that allow you to add or remove users from a team. These are available in API versions 2024-01
and later!
mutation {
add_users_to_team (team_id: 7654321, user_ids: [123456, 654321, 012345]) {
successful_users {
name
email
}
failed_users {
name
email
}
}
}
mutation {
remove_users_from_team (team_id: 7654321, user_ids: [123456, 654321, 012345]) {
successful_users {
name
email
}
failed_users {
name
email
}
}
}