Method: projects.locations.agents.testCases.import

Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwite any existing ones. The provided ID in the imported test case is neglected.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

HTTP request

POST https://{endpoint}/v3/{parent=projects/*/locations/*/agents/*}/testCases:import

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



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

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

  • dialogflow.testcases.import

Request body

The request body contains data with the following structure:

JSON representation

  // Union field source can be only one of the following:
  "gcsUri": string,
  "content": string
  // End of list of possible types for union field source.
Union field source. Required. The source to import. source can be only one of the following:


The Google Cloud Storage URI to import test cases from. The format of this URI must be gs://<bucket-name>/<object-name>.


string (bytes format)

Uncompressed raw byte content for test cases.

A base64-encoded string.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.