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 versions.

🚧

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

Query version instead!

Queries

Get versions

  • 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

FieldTypeDescriptionEnum Values
display_nameString!The API version's display name.
kindVersionKind!The type of API version.current
deprecated
maintenance
previous_maintenance
release_candidate
valueString!The API version name. Can be passed in the API-Version header.