At monday.com, we support multiple versions of the API to provide stability for devs while allowing us to continuously improve the API. You can find the list of current versions in our documentation, or you can use the versions API.

If you would like to return metadata about the specific API version used during a request (not all of the available versions), you can query the version object instead.

Queries

Querying versions will return metadata about all available API versions. This method does not accept any arguments and returns an array.

You can only query versions directly at the root, so it can't be nested within another query.

query {
  versions {
    kind
    value
    display_name
  }
}

let query = 'query { versions { kind value display_name }}';

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     'query' : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

This query would return the following:

{
  "data": {
    "versions": [
      {
        "display_name": "Previous Maintenance",
        "kind": "previous_maintenance",
        "value": "2024-01"
      },
      {
        "display_name": "Maintenance",
        "kind": "maintenance",
        "value": "2024-04"
      },
      {
        "display_name": "Current",
        "kind": "current",
        "value": "2024-07"
      },
      {
        "display_name": "Release Candidate",
        "kind": "release_candidate",
        "value": "2024-10"
      }
    ]
  },
  "account_id": 1
}

Fields

You can use the following field(s) to specify what information your versions query will return.

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎