We have added a new field, items_count, to the boards query.

This new field will return the number of items on boards across an account or across certain boards if specified in the query.

The items_count field can be called like this:

query {
  boards {
    items_count
  }
}

With this new field, you can enjoy more ease in working with board data, as you will no longer have to do a manual count of items in your account.

🚧

High complexity cost query

Be sure to use the items_count query with caution, as it comes with a high complexity cost. See more on Rate Limiting here.

Happy building! 🛠

Hello monday builder!

We have released a collection of Postman HTTP request examples to help out community 💪

You can find the collection here.

Let us know what you think!

Cheers,
Matias

Hello all!

We have some exciting documentation news today 🚀

We have moved our documentation to be hosted on developer.monday.com. This change will provide you with a more unified experience when navigating and searching through our API and App Framework documentation.


After September 17th, the old URLs (api.developer.monday.com and apps.developer.monday.com) will no longer work.

Be sure to update your bookmarks accordingly.

If you see any broken links, please let us know at [email protected]!

Happy building ⚒️

We have aligned our API for the webhook events: 

• create_subitem
• delete_subitem
• archive_subitem

They now return itemId and pulseId when the event is triggered.

In one week, you will see a descriptive error when you try to add a user to a person column when the user is not assigned to the board.

Previously, this would result in a nonspecific 500 error.

In one week, providing a nonexistent board in a “items_by_column_values” query will result in a 500 error.

In one week, sending an invalid user ID in a create_notification mutation will result in a 500 error.

A valid user ID must be an integer.

The items query is changing to return no items when the limit is set to 0.

Below is an example of the items query with a limit of 0:

query {
  boards {
      items (limit: 0) {
        id
    }
  }
}

The query above will return no items.

Previously, a limit of 0 in an items query would return all items across an account.

Happy building!

You can now retrieve the type of the boards using the type field!

There are three different board types:

• Board (Parent board)
• Sub Items board
• Document

{
  boards(ids:1234567890){
    type
  }
}

{
  "data": {
    "boards": [
      {
        "type": "board"
      }
    ]
  },
  "account_id": 1111111
}

{
  boards(ids:1234567890){
    type
  }
}

{
  "data": {
    "boards": [
      {
        "type": "sub_items_board"
      }
    ]
  },
  "account_id": 1111111
}

{
  boards(ids:1234567890){
    type
  }
}

{
  "data": {
    "boards": [
      {
        "type": "document"
      }
    ]
  },
  "account_id": 1111111
}

You can now query for a user's language via the API!

A user's language can be obtained with a query like this:

query {
    users (ids: [123456789]) {
    		name
     		current_language
    }
}

You can expect a response like this from the query above:

{
  "data": {
    "users": [
      {
        "name": "John Appleseed",
        "current_language": "en"
      }
    ]
  },
  "account_id": 123456789
}

Happy building!