Versions

Learn how to access all supported API versions using the monday.com platform API

At monday.com, we support multiple API versions to provide users with stability while still allowing us to continuously make improvements. You can find a list of current versions here, or you query the versions endpoint.

🚧

Only want data about the specific version used in a request?

Query the version endpoint instead!

Queries

You can use the versions query to retrieve data about available API versions via the API.

  • Returns an array containing metadata about all available API versions
  • Can only be queried directly at the root; can't be nested within another query
query {
  versions {
    kind
    value
    display_name
  }
}
{
  "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 fields to specify what information your versions query will return.

Field

Description

Enum Values

display_name String!

The API version's display name.

kind VersionKind!

The type of API version.

current
deprecated
maintenance
previous_maintenance
release_candidate

value String!

The API version name. Can be passed in the API-Version header.