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.
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
}
}
}
Starting today, we have a new support form to open a technical ticket with our team! This new form helps us to route your requests and gather useful information about the issues you are experiencing. This will allow us to address your concerns more effectively and provide you with a faster resolution.
The [email protected] email address will no longer be valid. It is set to auto-close and will become a no-reply email address. Moving forward, we encourage all developers to utilize our new support form. App users should reach out via the monday.com support center as usual.
This transition is aimed at improving the support process and enhancing your overall developer experience with our API and app marketplace!
On Jan 16th 2024, we will begin a gradual release of API version 2024-01 as the stable and default version.
If you've migrated your apps already (to 2023-10
or beyond) and want to use an up-to-date API version, you can:
"API-Version" : "2024-01"
setApiVersion
option if using the Javascript SDKTake note of this slight update from the previous announcement – we originally communicated the change would be in effect at 00:00 GMT.
You can now query a workspace's team owners using the team_owners_subscribers
field on a workspaces
query. This field is available in API versions 2024-01
and later. You can read more about workspaces and the supported fields in our documentation!
The following query would return the name and ID of the team owners in workspace 1234567.
query {
workspaces (ids: 1234567) {
team_owners_subscribers {
name
id
}
}
In API versions 2024-01
and later, you can use the new delete_teams_from_board
mutation to remove teams from a board. You can find more info about this new query in our documentation!
The following example would remove teams 123456, 654321, and 012345 from board 1234567890.
query {
delete_teams_from_board (board_id: 1234567890, team_ids: [123456, 654321, 012345]) {
id
}
}
In API versions 2024-01
and later, you can add the kind
argument to an add_teams_to_board
mutation to specify the team's role on the board. If this argument is not used, the team will automatically be added as a subscriber. Check out our documentation for more info!
The following example would add teams 654321 and 123456 to board 1234567890 as owners.
mutation {
add_teams_to_board (board_id: 1234567890, kind: owner, team_ids: [654321, 123456]) {
id
}
}
We recently introduced a hotfix to 2023-10
that returns ""
instead of null
for most empty column values when querying the text
field through column_values
V2. This hotfix aligns the 2023-10
behavior to what was returned in 2023-07
.
Each column does NOT have the same expected behavior. It is essential to check out the column types reference to verify the expected result for each column.
The list below summarizes the expected behavior:
""
if the column is empty; otherwise, they'll return the column value as textnull
""
null
if the column is empty; otherwise, they'll return the column value as textThe new pricing_version
field on app_subscription
queries returns the subscription's pricing version. This field is only available on API versions 2024-01
and later.
query {
app_subscription {
pricing_version
billing_period
renewal_date
}
}