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!

You can now retrieve an item’s email address via the API!

The 'items' query will now accept an 'email' field. Here is an example of a query for an item's email address:

query {
  boards (ids: 12345678) {
    items {
      id
      email
    }
  }
}

The query above will result in a response like this:

{
  "data": {
    "boards": [
      {
        "items": [
          {
            "id": "1234567899",
            "email": "[email protected]"
          }
        ]
      }
    ]
  },
  "account_id": 1234567898
}

Happy building!