Method: projects.locations.collections.dataStores.conversations.create

Creates a Conversation.

If the Conversation to create already exists, an ALREADY_EXISTS error is returned.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Full resource name of parent data store. Format: projects/{projectNumber}/locations/{locationId}/collections/{collection}/dataStores/{dataStoreId}

Request body

The request body contains an instance of Conversation.

Response body

If successful, the response body contains a newly created instance of Conversation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • discoveryengine.conversations.create

For more information, see the IAM documentation.