Join the Dialogflow CX competition! Get trained in Dialogflow CX, work on open-source conversational components, get a free Dialogflow t-shirt and win cool prizes! Learn more.

Method: projects.locations.agents.validate

Validates the specified agent and creates or updates validation results. The agent in draft version is validated. Please call this API after the training is completed to get the complete validation results.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The agent to validate. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>.

Authorization requires the following IAM permission on the specified resource name:

  • dialogflow.agents.validate

Request body

The request body contains data with the following structure:

JSON representation
  "languageCode": string


If not specified, the agent's default language is used.

Response body

If successful, the response body contains an instance of AgentValidationResult.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.