Dynamic languages (Python, Node.js, Ruby):
Upgrade the package,
and your code will automatically use the latest stable version.
Static languages (Java, C#, PHP, Go):
Install the new package
and update all import statements to reference "v2" instead of "v2beta1".
The field that controls whether
machine learning (ML) is enabled for an Intent has changed.
The mlEnabled field has been removed and replaced by the mlDisabled
field, and ML is enabled by default.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe V2 API is the stable version, and the V2beta1 API was used for beta features, so users should transition to the V2 API.\u003c/p\u003e\n"],["\u003cp\u003eFor REST or RPC, update the endpoint URL from \u003ccode\u003edialogflow.googleapis.com/v2beta1/...\u003c/code\u003e to \u003ccode\u003edialogflow.googleapis.com/v2/...\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eClient library users need to update their packages: dynamic languages can simply upgrade the package, while static languages must install the new package and update import statements to "v2".\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003emlEnabled\u003c/code\u003e field in V2beta1 has been replaced by \u003ccode\u003emlDisabled\u003c/code\u003e in V2, and machine learning is now enabled by default in the V2 version.\u003c/p\u003e\n"]]],[],null,["# Migrating between Dialogflow versions\n\nV2beta1 to V2\n-------------\n\nThe V2beta1 API is used to share beta features with Dialogflow users.\nThis section has advice for switching to the stable V2 API.\n| **Important:** The default behavior for enabling machine learning has changed. See details below.\n\n- If you are using REST or RPC, update the endpoint from `dialogflow.googleapis.com/v2beta1/...` to `dialogflow.googleapis.com/v2/...`\n- If you are using a [client library](/dialogflow/docs/reference/libraries), update it:\n - **Dynamic languages** (Python, Node.js, Ruby): Upgrade the package, and your code will automatically use the latest stable version.\n - **Static languages** (Java, C#, PHP, Go): Install the new package and update all import statements to reference \"v2\" instead of \"v2beta1\".\n- The field that controls whether machine learning (ML) is enabled for an `Intent` has changed. The `mlEnabled` field has been removed and replaced by the `mlDisabled` field, and ML is enabled by default."]]
